@oddkin/ai 0.0.0-stage → 1.0.0-beta.1

package/dist/response/response.js

@@ -0,0 +1,188 @@
+import { OddkinElement, prop } from '@oddkin/core/element';
+import { signal } from '@oddkin/core/reactive';
+import { announceEvent } from '../events.js';
+import { strings } from '../internal/strings.js';
+import { MarkdownView } from '../markdown/render.js';
+export const RESPONSE_STRINGS = {
+    streaming: 'Generating…',
+    interrupted: 'The connection ended before the response finished. What is shown may be incomplete.',
+    cancelled: 'Stopped. The partial response is kept.',
+    failed: 'The response failed.',
+    copy: 'Copy response',
+    copyCode: 'Copy code',
+    copied: 'Copied to clipboard.',
+    copyFailed: 'Copying failed.',
+    image: 'Image',
+};
+/**
+ * Streamed rich text (Oddkin Markdown) with partial-output, completion, interruption, and error
+ * states. The canonical source is `text`; rendering repairs incomplete syntax for display only,
+ * and copy always uses `text`. Untrusted content stays inert: no HTML parsing, URL allow-list,
+ * code rendered as text.
+ *
+ * @csspart content - The rendered Markdown.
+ * @csspart status - Status line (generating, interrupted, stopped, failed).
+ * @csspart actions - Copy action.
+ * @cssprop --odd-response-code-background - Code block background.
+ * @a11y Streaming text is not a live region (no per-token announcements); outcomes are announced by the surface's announcer. Committed blocks keep their DOM, so focus and selection inside them survive streaming.
+ * @keyboard Code blocks and wide tables are scrollable and focusable.
+ * @useFor Assistant output that may stream: answers, explanations, summaries.
+ * @notFor User-authored text (render it literally) or trusted HTML.
+ * @limitation Raw HTML renders as text unless `markdown.html` is `sanitize` with a host sanitizer. Images render as links unless `markdown.images` is `load`.
+ * @customization 1 2
+ * @category AI
+ */
+export class OddkinResponse extends OddkinElement.with({
+    text: prop.string({
+        default: '',
+        attribute: false,
+        description: 'Canonical Markdown source (property only).',
+    }),
+    status: prop.enum(['streaming', 'complete', 'interrupted', 'cancelled', 'failed'], {
+        default: 'complete',
+        reflect: true,
+        description: 'Lifecycle of the text.',
+    }),
+    error: prop.object({ description: 'Error shown when `status` is failed.' }),
+    sources: prop.array({
+        description: 'Sources that `[^id]` citations resolve against.',
+    }),
+    markdown: prop.object({
+        description: 'Renderer options: URL policy, sanitizer, highlighter, images.',
+    }),
+    copyable: prop.boolean({ description: 'Show a copy action for the whole response.' }),
+    strings: prop.object({
+        description: 'Localized string overrides.',
+    }),
+}) {
+    static events = { 'odd-announce': announceEvent };
+    /** @internal Bumps when rendered output changes (for tests and hosts measuring work). */
+    _renders = signal(0);
+    #view;
+    #frame;
+    #citations = new Map();
+    /** @internal */
+    get _strings() {
+        return strings(RESPONSE_STRINGS, this.strings);
+    }
+    /** The canonical source currently rendered. */
+    get renderedSource() {
+        return this.#view?.source ?? '';
+    }
+    /** Copy the canonical source (never the rendered DOM text). */
+    async copy(text = this.text) {
+        try {
+            await navigator.clipboard.writeText(text);
+            this.emit(announceEvent, {
+                text: this._strings.copied,
+                priority: 'polite',
+                key: `copy:${Date.now()}`,
+            });
+            return true;
+        }
+        catch {
+            this.emit(announceEvent, {
+                text: this._strings.copyFailed,
+                priority: 'polite',
+                key: `copy-failed:${Date.now()}`,
+            });
+            return false;
+        }
+    }
+    /** @internal */
+    _copy = () => void this.copy();
+    mounted(scope) {
+        const content = this.shadowRoot?.querySelector('[part="content"]');
+        if (!content)
+            return;
+        this.#citations.clear();
+        this.#view = new MarkdownView(content, this.#options());
+        scope.add(() => {
+            if (this.#frame !== undefined)
+                cancelAnimationFrame(this.#frame);
+            this.#frame = undefined;
+            this.#view?.dispose();
+            this.#view = undefined;
+        }, 'markdown view');
+        let first = true;
+        scope.effect(() => {
+            const options = this.markdown;
+            void options;
+            if (first) {
+                first = false;
+                return;
+            }
+            this.#citations.clear();
+            this.#view?.configure(this.#options());
+        }, { phase: 'post', name: '<odd-response> options' });
+        scope.effect(() => {
+            const text = this.text;
+            const streaming = this.status === 'streaming';
+            // Ingestion is immediate; DOM work is coalesced to one update per frame while streaming.
+            if (streaming) {
+                if (this.#frame === undefined)
+                    this.#frame = requestAnimationFrame(() => {
+                        this.#frame = undefined;
+                        this.#render(this.text, this.status === 'streaming');
+                    });
+            }
+            else {
+                if (this.#frame !== undefined)
+                    cancelAnimationFrame(this.#frame);
+                this.#frame = undefined;
+                this.#render(text, false);
+            }
+        }, { phase: 'post', name: '<odd-response> render' });
+        scope.effect(() => {
+            const sources = this.sources;
+            for (const [id, elements] of this.#citations) {
+                const index = sources.findIndex((s) => s.sourceId === id);
+                for (const el of elements) {
+                    el.source = sources[index];
+                    el.index = index + 1;
+                }
+            }
+        }, { phase: 'post', name: '<odd-response> citations' });
+    }
+    #render(text, streaming) {
+        this.#view?.update(text, streaming);
+        // Citations replaced by a re-rendered block are no longer updated.
+        for (const [id, elements] of this.#citations) {
+            for (const el of elements)
+                if (!el.isConnected)
+                    elements.delete(el);
+            if (!elements.size)
+                this.#citations.delete(id);
+        }
+        this._renders.value = this._renders.peek() + 1;
+    }
+    #options() {
+        const t = this._strings;
+        const doc = this.ownerDocument;
+        return {
+            imageLabel: t.image,
+            ...this.markdown,
+            citation: (id) => {
+                const el = doc.createElement('odd-citation');
+                const index = this.sources.findIndex((s) => s.sourceId === id);
+                el.sourceId = id;
+                el.source = this.sources[index];
+                el.index = index + 1;
+                let set = this.#citations.get(id);
+                if (!set)
+                    this.#citations.set(id, (set = new Set()));
+                set.add(el);
+                return el;
+            },
+            codeActions: (code) => {
+                const button = doc.createElement('button');
+                button.type = 'button';
+                button.className = 'text-button copy-code';
+                button.textContent = t.copyCode;
+                button.addEventListener('click', () => void this.copy(code));
+                return button;
+            },
+        };
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/response/response.js.map

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

package/dist/response/response.styles.d.ts

@@ -0,0 +1,3 @@
+/** Typography for rendered Markdown plus response states. */
+export declare const responseStyles: import("@oddkin/core/styles").CSSResult;
+//# sourceMappingURL=response.styles.d.ts.map

package/dist/response/response.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.styles.d.ts","sourceRoot":"","sources":["../../src/response/response.styles.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAC7D,eAAO,MAAM,cAAc,yCAsI1B,CAAC"}

package/dist/response/response.styles.js

@@ -0,0 +1,139 @@
+import { css } from '@oddkin/core/styles';
+import { token } from '@oddkin/tokens/refs';
+/** Typography for rendered Markdown plus response states. */
+export const responseStyles = css `
+  .content > :first-child {
+    margin-block-start: 0;
+  }
+  .content > :last-child {
+    margin-block-end: 0;
+  }
+  .content :is(p, ul, ol, blockquote, .code-block, .table-scroll, hr) {
+    margin-block: 0 ${token('space.sm')};
+  }
+  .content :is(h2, h3, h4, h5, h6) {
+    margin-block: ${token('space.md')} ${token('space.xs')};
+    line-height: ${token('line-height.tight')};
+  }
+  .content h3 {
+    font-size: ${token('font.size.lg')};
+  }
+  .content :is(h4, h5, h6) {
+    font-size: ${token('font.size.md')};
+  }
+  .content :is(ul, ol) {
+    padding-inline-start: ${token('space.lg')};
+  }
+  .content blockquote {
+    margin-inline: 0;
+    padding-inline-start: ${token('space.sm')};
+    border-inline-start: ${token('border.width.strong')} solid ${token('color.border.strong')};
+    color: ${token('color.text.secondary')};
+  }
+  .content a {
+    color: ${token('color.link')};
+  }
+  .content .unsafe-link {
+    text-decoration-line: underline;
+    text-decoration-style: dotted;
+  }
+  .content code {
+    font-family: ${token('font.family.mono')};
+    font-size: 0.9em;
+  }
+  .content :not(pre) > code {
+    padding-inline: 0.25em;
+    border-radius: ${token('radius.sm')};
+    background: ${token('color.surface.sunken')};
+  }
+  .code-block {
+    border: ${token('border.width.default')} solid ${token('color.border.default')};
+    border-radius: ${token('radius.md')};
+    background: var(--odd-response-code-background, ${token('color.surface.sunken')});
+  }
+  .code-block pre {
+    margin: 0;
+    padding: ${token('space.sm')};
+    overflow-x: auto;
+    white-space: pre;
+  }
+  .code-block .copy-code {
+    margin: 0 ${token('space.2xs')} ${token('space.2xs')};
+  }
+  .tok-keyword {
+    color: ${token('color.link')};
+    font-weight: ${token('font.weight.semibold')};
+  }
+  .tok-string {
+    color: ${token('color.success.foreground')};
+  }
+  .tok-comment {
+    color: ${token('color.text.secondary')};
+    font-style: italic;
+  }
+  .tok-number {
+    color: ${token('color.danger.foreground')};
+  }
+  .table-scroll {
+    overflow-x: auto;
+  }
+  .content table {
+    border-collapse: collapse;
+    font-size: ${token('font.size.sm')};
+  }
+  .content :is(th, td) {
+    padding: ${token('space.2xs')} ${token('space.xs')};
+    border: ${token('border.width.default')} solid ${token('color.border.default')};
+    text-align: start;
+    vertical-align: top;
+  }
+  .content [data-align='center'] {
+    text-align: center;
+  }
+  .content [data-align='right'] {
+    text-align: end;
+  }
+  .content .raw-html {
+    font-family: ${token('font.family.mono')};
+    font-size: ${token('font.size.sm')};
+    white-space: pre-wrap;
+  }
+  .status-line {
+    margin: ${token('space.xs')} 0 0;
+    color: ${token('color.text.secondary')};
+    font-size: ${token('font.size.sm')};
+  }
+  .status-line[data-status='failed'] {
+    color: ${token('color.danger.foreground')};
+  }
+  .status-line[data-status='streaming']::before {
+    content: '';
+    display: inline-block;
+    inline-size: 0.5em;
+    block-size: 0.5em;
+    margin-inline-end: ${token('space.2xs')};
+    border-radius: ${token('radius.full')};
+    background: currentColor;
+    animation: odd-response-pulse 1.2s ease-in-out infinite;
+  }
+  @keyframes odd-response-pulse {
+    50% {
+      opacity: 0.3;
+    }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .status-line[data-status='streaming']::before {
+      animation: none;
+    }
+  }
+  .actions {
+    margin-block-start: ${token('space.2xs')};
+  }
+  @media (forced-colors: active) {
+    .code-block,
+    .content :is(th, td) {
+      border-color: CanvasText;
+    }
+  }
+`;
+//# sourceMappingURL=response.styles.js.map

package/dist/response/response.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.styles.js","sourceRoot":"","sources":["../../src/response/response.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;;;;;;;;sBAQX,KAAK,CAAC,UAAU,CAAC;;;oBAGnB,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC;mBACvC,KAAK,CAAC,mBAAmB,CAAC;;;iBAG5B,KAAK,CAAC,cAAc,CAAC;;;iBAGrB,KAAK,CAAC,cAAc,CAAC;;;4BAGV,KAAK,CAAC,UAAU,CAAC;;;;4BAIjB,KAAK,CAAC,UAAU,CAAC;2BAClB,KAAK,CAAC,qBAAqB,CAAC,UAAU,KAAK,CAAC,qBAAqB,CAAC;aAChF,KAAK,CAAC,sBAAsB,CAAC;;;aAG7B,KAAK,CAAC,YAAY,CAAC;;;;;;;mBAOb,KAAK,CAAC,kBAAkB,CAAC;;;;;qBAKvB,KAAK,CAAC,WAAW,CAAC;kBACrB,KAAK,CAAC,sBAAsB,CAAC;;;cAGjC,KAAK,CAAC,sBAAsB,CAAC,UAAU,KAAK,CAAC,sBAAsB,CAAC;qBAC7D,KAAK,CAAC,WAAW,CAAC;sDACe,KAAK,CAAC,sBAAsB,CAAC;;;;eAIpE,KAAK,CAAC,UAAU,CAAC;;;;;gBAKhB,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC;;;aAG3C,KAAK,CAAC,YAAY,CAAC;mBACb,KAAK,CAAC,sBAAsB,CAAC;;;aAGnC,KAAK,CAAC,0BAA0B,CAAC;;;aAGjC,KAAK,CAAC,sBAAsB,CAAC;;;;aAI7B,KAAK,CAAC,yBAAyB,CAAC;;;;;;;iBAO5B,KAAK,CAAC,cAAc,CAAC;;;eAGvB,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC;cACxC,KAAK,CAAC,sBAAsB,CAAC,UAAU,KAAK,CAAC,sBAAsB,CAAC;;;;;;;;;;;mBAW/D,KAAK,CAAC,kBAAkB,CAAC;iBAC3B,KAAK,CAAC,cAAc,CAAC;;;;cAIxB,KAAK,CAAC,UAAU,CAAC;aAClB,KAAK,CAAC,sBAAsB,CAAC;iBACzB,KAAK,CAAC,cAAc,CAAC;;;aAGzB,KAAK,CAAC,yBAAyB,CAAC;;;;;;;yBAOpB,KAAK,CAAC,WAAW,CAAC;qBACtB,KAAK,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;0BAef,KAAK,CAAC,WAAW,CAAC;;;;;;;;CAQ3C,CAAC"}

package/dist/response/response.template.d.ts

@@ -0,0 +1,7 @@
+import type { OddkinResponse } from './response.js';
+/**
+ * Anatomy: `content` (rendered by the Markdown view; the template never binds inside it), a
+ * `status` line, and `actions`.
+ */
+export declare const responseTemplate: (host: OddkinResponse) => import("@oddkin/core/template").TemplateResult;
+//# sourceMappingURL=response.template.d.ts.map

package/dist/response/response.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.template.d.ts","sourceRoot":"","sources":["../../src/response/response.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,SAAU,cAAc,mDAkBpD,CAAC"}

package/dist/response/response.template.js

@@ -0,0 +1,24 @@
+import { html } from '@oddkin/core/template';
+/**
+ * Anatomy: `content` (rendered by the Markdown view; the template never binds inside it), a
+ * `status` line, and `actions`.
+ */
+export const responseTemplate = (host) => {
+    const t = host._strings;
+    const status = host.status;
+    const message = status === 'streaming'
+        ? t.streaming
+        : status === 'interrupted'
+            ? t.interrupted
+            : status === 'cancelled'
+                ? t.cancelled
+                : status === 'failed'
+                    ? host.error?.message || t.failed
+                    : '';
+    return html `<div part="content" class="content"></div>
+    <p part="status" class="status-line" data-status=${status} ?hidden=${!message}>${message}</p>
+    <div part="actions" class="actions" ?hidden=${!host.copyable || status === 'streaming'}>
+      <button class="text-button" type="button" @click=${host._copy}>${t.copy}</button>
+    </div>`;
+};
+//# sourceMappingURL=response.template.js.map

package/dist/response/response.template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.template.js","sourceRoot":"","sources":["../../src/response/response.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAG7C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAoB,EAAE,EAAE;IACvD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,OAAO,GACX,MAAM,KAAK,WAAW;QACpB,CAAC,CAAC,CAAC,CAAC,SAAS;QACb,CAAC,CAAC,MAAM,KAAK,aAAa;YACxB,CAAC,CAAC,CAAC,CAAC,WAAW;YACf,CAAC,CAAC,MAAM,KAAK,WAAW;gBACtB,CAAC,CAAC,CAAC,CAAC,SAAS;gBACb,CAAC,CAAC,MAAM,KAAK,QAAQ;oBACnB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,CAAC,MAAM;oBACjC,CAAC,CAAC,EAAE,CAAC;IACf,OAAO,IAAI,CAAA;uDAC0C,MAAM,YAAY,CAAC,OAAO,IAAI,OAAO;kDAC1C,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,KAAK,WAAW;yDACjC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI;WAClE,CAAC;AACZ,CAAC,CAAC"}

package/dist/response-feedback/index.d.ts

@@ -0,0 +1,5 @@
+export { OddkinResponseFeedback, FEEDBACK_STRINGS } from './response-feedback.js';
+export { responseFeedbackTemplate } from './response-feedback.template.js';
+export { responseFeedbackStyles } from './response-feedback.styles.js';
+export { responseFeedbackDefinition } from './response-feedback.definition.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/response-feedback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/response-feedback/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/response-feedback/index.js

@@ -0,0 +1,6 @@
+// Side-effect free. Register with `@oddkin/ai/define/response-feedback`.
+export { OddkinResponseFeedback, FEEDBACK_STRINGS } from './response-feedback.js';
+export { responseFeedbackTemplate } from './response-feedback.template.js';
+export { responseFeedbackStyles } from './response-feedback.styles.js';
+export { responseFeedbackDefinition } from './response-feedback.definition.js';
+//# sourceMappingURL=index.js.map

package/dist/response-feedback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/response-feedback/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/response-feedback/response-feedback.d.ts

@@ -0,0 +1,92 @@
+import { OddkinElement, type ElementEvents } from '@oddkin/core/element';
+import type { Scope } from '@oddkin/core/scope';
+export declare const FEEDBACK_STRINGS: {
+    label: string;
+    positive: string;
+    negative: string;
+    reasons: string;
+    comment: string;
+    submit: string;
+    cancel: string;
+    pending: string;
+    submitted: string;
+    failed: string;
+    retry: string;
+};
+declare const OddkinResponseFeedback_base: import("@oddkin/core/element").WithProps<typeof OddkinElement, {
+    readonly messageId: import("@oddkin/core/element").PropDefinition<string>;
+    readonly feedback: import("@oddkin/core/element").PropDefinition<{
+        comment?: string | undefined;
+        error?: {
+            code: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+        messageId: string;
+        rating?: "negative" | "positive" | undefined;
+        reasons?: string[] | undefined;
+        status: "failed" | "idle" | "pending" | "submitted";
+    } | undefined>;
+    readonly reasons: import("@oddkin/core/element").PropDefinition<string[]>;
+    readonly disabled: import("@oddkin/core/element").PropDefinition<boolean>;
+    readonly announce: import("@oddkin/core/element").PropDefinition<"important" | "none">;
+    readonly strings: import("@oddkin/core/element").PropDefinition<Partial<{
+        label: string;
+        positive: string;
+        negative: string;
+        reasons: string;
+        comment: string;
+        submit: string;
+        cancel: string;
+        pending: string;
+        submitted: string;
+        failed: string;
+        retry: string;
+    }> | undefined>;
+}>;
+/**
+ * Feedback on one response: a rating, optional reasons and comment, a pending state, and the
+ * confirmed outcome from the feedback record.
+ *
+ * @csspart base - The feedback surface.
+ * @csspart form - Reasons and comment.
+ * @a11y Ratings are toggle buttons (`aria-pressed`). The outcome text comes from the record, never from the local request.
+ * @keyboard Tab and Enter or Space; the form keeps focus order rating → reasons → comment → submit.
+ * @useFor Collecting user feedback on generated responses.
+ * @notFor Surveys or general forms.
+ * @customization 1 2
+ * @category AI
+ */
+export declare class OddkinResponseFeedback extends OddkinResponseFeedback_base {
+    static events: {
+        'odd-feedback-submit': import("@oddkin/core/element").EventDefinition<import("../events.js").FeedbackSubmitDetail>;
+        'odd-announce': import("@oddkin/core/element").EventDefinition<import("../events.js").AnnounceDetail>;
+    };
+    readonly _events?: ElementEvents<typeof OddkinResponseFeedback>;
+    /** @internal Local draft (presentation state). */
+    readonly _rating: import("@oddkin/core/reactive").Signal<"negative" | "positive" | undefined>;
+    /** @internal */
+    readonly _selected: import("@oddkin/core/reactive").Signal<readonly string[]>;
+    /** @internal */
+    readonly _comment: import("@oddkin/core/reactive").Signal<string>;
+    /** @internal */
+    get _strings(): typeof FEEDBACK_STRINGS;
+    /** @internal */
+    readonly _rate: (event: Event) => void;
+    /** @internal */
+    readonly _toggleReason: (event: Event) => void;
+    /** @internal */
+    readonly _onComment: (event: Event) => void;
+    /** @internal */
+    readonly _cancel: () => void;
+    /** @internal */
+    readonly _submit: (event: Event) => void;
+    protected mounted(scope: Scope): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'odd-response-feedback': OddkinResponseFeedback;
+    }
+}
+export {};
+//# sourceMappingURL=response-feedback.d.ts.map

package/dist/response-feedback/response-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-feedback.d.ts","sourceRoot":"","sources":["../../src/response-feedback/response-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAQ,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAMhD,eAAO,MAAM,gBAAgB;IAC3B,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,MAAM;IACN,KAAK;CACN,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,SAAQ,2BAmB1C;IACA,OAAgB,MAAM;QACpB,qBAAqB;QACrB,cAAc;MACd;IACF,SAAiB,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAExE,kDAAkD;IAClD,QAAQ,CAAC,OAAO,8EAA0D;IAC1E,gBAAgB;IAChB,QAAQ,CAAC,SAAS,4DAAiC;IACnD,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,iDAAc;IAE/B,gBAAgB;IAChB,IAAI,QAAQ,IAAI,OAAO,gBAAgB,CAEtC;IAED,gBAAgB;IAChB,QAAQ,CAAC,KAAK,UAAW,KAAK,KAAG,IAAI,CAInC;IACF,gBAAgB;IAChB,QAAQ,CAAC,aAAa,UAAW,KAAK,KAAG,IAAI,CAM3C;IACF,gBAAgB;IAChB,QAAQ,CAAC,UAAU,UAAW,KAAK,KAAG,IAAI,CAExC;IACF,gBAAgB;IAChB,QAAQ,CAAC,OAAO,QAAO,IAAI,CAIzB;IACF,gBAAgB;IAChB,QAAQ,CAAC,OAAO,UAAW,KAAK,KAAG,IAAI,CAUrC;IAEF,UAAmB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAgC7C;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,uBAAuB,EAAE,sBAAsB,CAAC;KACjD;CACF"}

package/dist/response-feedback/response-feedback.define.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="response-feedback.d.ts" preserve="true" />
+export {};
+//# sourceMappingURL=response-feedback.define.d.ts.map

package/dist/response-feedback/response-feedback.define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-feedback.define.d.ts","sourceRoot":"","sources":["../../src/response-feedback/response-feedback.define.ts"],"names":[],"mappings":""}

package/dist/response-feedback/response-feedback.define.js

@@ -0,0 +1,5 @@
+/// <reference path="./response-feedback.ts" preserve="true" />
+import { define } from '@oddkin/core/element';
+import { responseFeedbackDefinition } from './response-feedback.definition.js';
+define(responseFeedbackDefinition);
+//# sourceMappingURL=response-feedback.define.js.map

package/dist/response-feedback/response-feedback.define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-feedback.define.js","sourceRoot":"","sources":["../../src/response-feedback/response-feedback.define.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,MAAM,CAAC,0BAA0B,CAAC,CAAC"}

package/dist/response-feedback/response-feedback.definition.d.ts

@@ -0,0 +1,3 @@
+import { OddkinResponseFeedback } from './response-feedback.js';
+export declare const responseFeedbackDefinition: import("@oddkin/core/element").ElementDefinition<OddkinResponseFeedback>;
+//# sourceMappingURL=response-feedback.definition.d.ts.map

package/dist/response-feedback/response-feedback.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-feedback.definition.d.ts","sourceRoot":"","sources":["../../src/response-feedback/response-feedback.definition.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,eAAO,MAAM,0BAA0B,0EAMrC,CAAC"}

package/dist/response-feedback/response-feedback.definition.js

@@ -0,0 +1,14 @@
+import { buttonDefinition } from '@oddkin/components/button';
+import { compose } from '@oddkin/core/element';
+import { aiBaseStyles } from '../internal/base.styles.js';
+import { OddkinResponseFeedback } from './response-feedback.js';
+import { responseFeedbackStyles } from './response-feedback.styles.js';
+import { responseFeedbackTemplate } from './response-feedback.template.js';
+export const responseFeedbackDefinition = compose({
+    name: 'odd-response-feedback',
+    element: OddkinResponseFeedback,
+    template: responseFeedbackTemplate,
+    styles: [aiBaseStyles, responseFeedbackStyles],
+    dependencies: { button: buttonDefinition },
+});
+//# sourceMappingURL=response-feedback.definition.js.map

package/dist/response-feedback/response-feedback.definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-feedback.definition.js","sourceRoot":"","sources":["../../src/response-feedback/response-feedback.definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;IAChD,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,wBAAwB;IAClC,MAAM,EAAE,CAAC,YAAY,EAAE,sBAAsB,CAAC;IAC9C,YAAY,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE;CAC3C,CAAC,CAAC"}