@quartzds/core 1.0.0-beta.1

package/dist/types/components/checkbox/checkbox.d.ts

@@ -0,0 +1,136 @@
+import type { ComponentInterface } from '../../stencil-public-runtime';
+export type CheckboxValue = number | string | null;
+export type CheckboxSize = 'large' | 'small' | 'standard';
+/**
+ * `<qds-checkbox>` elements are rendered as boxes that are checked (ticked)
+ * when activated, like you might see in an official government paper form. A
+ * checkbox allows you to select single values for submission in a form (or not).
+ *
+ * @see https://quartz.se.com/build/components/checkbox
+ */
+export declare class Checkbox implements ComponentInterface {
+  /**
+   * Adds vertical margin to the checkbox for alignment.
+   *
+   * This is useful when creating inline layouts so that the first lines have
+   * the correct vertical centering.
+   */
+  readonly inline: boolean;
+  /**
+   * The checkbox's size.
+   */
+  readonly size: CheckboxSize;
+  /**
+   * The checkbox's text.
+   */
+  readonly text?: string;
+  /**
+   * Specify whether the checkbox should have focus when the page loads.
+   *
+   * @webnative
+   */
+  readonly autoFocus?: boolean;
+  /**
+   * Sets the checkbox's state.
+   *
+   * @webnative
+   */
+  checked?: boolean;
+  /**
+   * Prevents the checkbox from being interacted with: it cannot be pressed or
+   * focused.
+   *
+   * @webnative
+   */
+  disabled?: boolean;
+  /**
+   * The [`<form>`](https://developer.mozilla.org/docs/Web/HTML/Element/form)
+   * element to associate the checkbox with (its form owner).
+   *
+   * The value of this property must be the id of a `<form>` in the same
+   * document. If this property is not set, the `<qds-checkbox>` is associated
+   * with its ancestor `<form>` element, if any.
+   *
+   * This property lets you associate `<qds-checkbox>` elements to `<form>`s
+   * anywhere in the document, not just inside a `<form>`. It can also override
+   * an ancestor `<form>` element.
+   *
+   * @webnative
+   */
+  readonly form?: string;
+  /**
+   * Sets the checkbox to an indeterminate state. This is usually applied to
+   * checkboxes that represents a "select all/none" behavior when associated
+   * checkboxes have a mix of checked and unchecked states.
+   *
+   * @webnative
+   */
+  indeterminate?: boolean;
+  /**
+   * The name of the checkbox, which is submitted with the form data. An
+   * incrementing ID is used by default.
+   *
+   * @webnative
+   */
+  readonly name: string;
+  /**
+   * A value must be specified for the checkbox before the owning form can be
+   * submitted.
+   *
+   * See
+   * [Client-side validation](https://developer.mozilla.org/docs/Web/HTML/Element/input#client-side_validation)
+   * and the
+   * [HTML attribute: `required`](https://developer.mozilla.org/docs/Web/HTML/Attributes/required)
+   * for more information.
+   *
+   * @webnative
+   */
+  readonly required?: boolean;
+  /**
+   * The value of the checkbox, submitted as a name/value pair with form data.
+   *
+   * @webnative
+   */
+  value?: CheckboxValue;
+  /**
+   * Emitted when the checkbox loses focus.
+   */
+  private readonly blurEmitter;
+  /**
+   * Emitted when a change to the checkbox's state is committed by the user.
+   */
+  private readonly changeEmitter;
+  /**
+   * Emitted when the checkbox gains focus.
+   */
+  private readonly focusEmitter;
+  private readonly element;
+  private inheritedAttributes;
+  private input?;
+  private get computedDisabled();
+  private get computedIndeterminate();
+  private get hasText();
+  /**
+   * Returns whether a form will validate this checkbox when it is submitted
+   * without having to submit it.
+   */
+  checkValidity(): Promise<boolean>;
+  /**
+   * Returns true if the checkbox's value passes validity checks; otherwise,
+   * returns false, and (if the event isn't canceled) reports the problem to
+   * the user.
+   */
+  reportValidity(): Promise<boolean>;
+  /**
+   * Sets a custom validity message for the checkbox. If this message is not the
+   * empty string, then the checkbox is considered invalid.
+   */
+  setCustomValidity(message: string): Promise<void>;
+  protected onClick(event: MouseEvent): void;
+  componentWillLoad(): void;
+  render(): any;
+  private readonly ref;
+  private readonly onBlur;
+  private readonly onFocus;
+}
+//# sourceMappingURL=checkbox.d.ts.map

package/dist/types/components/create-story.d.ts

@@ -0,0 +1,5 @@
+import type { Args } from '@storybook/addons';
+import type { StoryObj } from '@storybook/web-components/types-7-0';
+declare const createStory: <TArgs = Args>(story: StoryObj<TArgs>) => StoryObj<TArgs>;
+export default createStory;
+//# sourceMappingURL=create-story.d.ts.map

package/dist/types/components/dropdown/dropdown.d.ts

@@ -0,0 +1,135 @@
+import type { AutoUpdateOptions, DetectOverflowOptions, FlipOptions, Placement, ReferenceElement, ShiftOptions, Strategy } from '@floating-ui/dom';
+import type { ComponentInterface } from '../../stencil-public-runtime';
+import type { OffsetOptions } from '../../helpers';
+/**
+ * @experimental
+ * @slot Content to display in the dropdown.
+ * @see https://quartz.se.com/build/components/dropdown
+ */
+export declare class Dropdown implements ComponentInterface {
+  /**
+   * Options to pass to Floating UI's
+   * [`autoUpdate()` function](https://floating-ui.com/docs/autoUpdate).
+   *
+   * @see https://floating-ui.com/docs/autoupdate#options
+   */
+  readonly autoUpdateOptions?: AutoUpdateOptions;
+  /**
+   * Prevents the dropdown from being shown by user interaction. The dropdown
+   * can still be displayed by calling the `show()` method.
+   */
+  disabled: boolean;
+  /**
+   * Options to pass to Floating UI's
+   * [`flip` middleware](https://floating-ui.com/docs/flip).
+   *
+   * The [`crossAxis` option](https://floating-ui.com/docs/flip#crossaxis) is
+   * set to the value of the `noShift` property by default for interoperability
+   * with the [`shift` middleware](https://floating-ui.com/docs/shift).
+   *
+   * @see https://floating-ui.com/docs/flip#options
+   */
+  readonly flipOptions?: Partial<DetectOverflowOptions & FlipOptions>;
+  /**
+   * Disable Floating UI's
+   * [`flip` middleware](https://floating-ui.com/docs/flip).
+   */
+  readonly noFlip: boolean;
+  /**
+   * Disable Floating UI's
+   * [`shift` middleware](https://floating-ui.com/docs/shift).
+   */
+  readonly noShift: boolean;
+  /**
+   * Options to pass to Floating UI's
+   * [`offset` middleware](https://floating-ui.com/docs/offset).
+   *
+   * The [`mainAxis` option](https://floating-ui.com/docs/offset#mainaxis) is
+   * not supported.
+   *
+   * @see https://floating-ui.com/docs/offset#options
+   */
+  readonly offsetOptions?: OffsetOptions;
+  /**
+   * Where to place the dropdown relative to the `target`.
+   *
+   * @see https://floating-ui.com/docs/tutorial#placements
+   */
+  readonly placement: Placement;
+  /**
+   * Options to pass to Floating UI's
+   * [`shift` middleware](https://floating-ui.com/docs/shift).
+   *
+   * @see https://floating-ui.com/docs/shift#options
+   */
+  readonly shiftOptions?: Partial<DetectOverflowOptions & ShiftOptions>;
+  /**
+   * The CSS position strategy to use.
+   *
+   * @see https://floating-ui.com/docs/computeposition#strategy
+   */
+  readonly strategy?: Strategy;
+  /**
+   * The trigger element that will trigger the dropdown. The target specified
+   * can be any of the follow:
+   *
+   * - A CSS selector string
+   * - A reference to an
+   * [`Element`](https://developer.mozilla.org/docs/Web/API/Element) or
+   * [Virtual Element](https://floating-ui.com/docs/virtual-elements)
+   * - A function returning a reference to an
+   * [`Element`](https://developer.mozilla.org/docs/Web/API/Element),
+   * [Virtual Element](https://floating-ui.com/docs/virtual-elements),
+   * or a CSS selector string
+   */
+  readonly target: ReferenceElement | string | (() => ReferenceElement | string);
+  /**
+   * Emitted when the user instructs the browser that they wish to dismiss the
+   * current open dropdown by pressing the `Esc` key.
+   *
+   * When a dropdown is dismissed with the `Esc` key, both the `qdsCancel` and
+   * `qdsClose` events are emitted.
+   */
+  private readonly cancelEmitter;
+  /**
+   * Emitted when the dropdown is closed.
+   */
+  private readonly closeEmitter;
+  private readonly element;
+  private hostAriaLabelledBy?;
+  private hostDisplay?;
+  private hostPosition?;
+  private hostTransform?;
+  private cleanup?;
+  private middleware?;
+  private referenceElement?;
+  private open;
+  /**
+   * Show the dropdown.
+   */
+  show(): Promise<void>;
+  /**
+   * Close the dropdown.
+   */
+  close(): Promise<void>;
+  /**
+   * Update the dropdown's middleware and position.
+   */
+  update(): Promise<void>;
+  protected handleMouseDown(event: MouseEvent): Promise<void>;
+  private updateReferenceElement;
+  private updateMiddleware;
+  private updatePosition;
+  private startAutoUpdate;
+  componentWillLoad(): Promise<void>;
+  disconnectedCallback(): void;
+  render(): any;
+  private handleFocusOut;
+  private readonly boundFocusout;
+  private handleEscape;
+  private readonly boundEscape;
+  private handleReferenceClick;
+  private readonly boundReferenceClick;
+  private disconnectReferenceElement;
+}
+//# sourceMappingURL=dropdown.d.ts.map

package/dist/types/components/icon/default-library.d.ts

@@ -0,0 +1,4 @@
+import type { IconLibrary } from './library';
+declare const library: IconLibrary;
+export default library;
+//# sourceMappingURL=default-library.d.ts.map

package/dist/types/components/icon/icon.d.ts

@@ -0,0 +1,31 @@
+import type { ComponentInterface } from '../../stencil-public-runtime';
+/**
+ * @experimental
+ */
+export declare class Icon implements ComponentInterface {
+  /**
+   * The name of the icon to render.
+   *
+   * Available names depend on the icon library being used.
+   */
+  readonly name: string;
+  /**
+   * The name of a registered icon library.
+   */
+  readonly library: string;
+  /**
+   * Emitted when the icon has loaded.
+   */
+  private readonly loadEmitter;
+  /**
+   * Emitted when the icon fails to load due to an error.
+   */
+  private readonly errorEmitter;
+  private readonly element;
+  private svg;
+  private inheritedAttributes;
+  private setIcon;
+  componentWillLoad(): Promise<void>;
+  render(): any;
+}
+//# sourceMappingURL=icon.d.ts.map

package/dist/types/components/icon/library.d.ts

@@ -0,0 +1,19 @@
+import type { Except } from 'type-fest';
+export type IconLibraryResolver = (name: string) => string;
+export interface IconLibrary {
+  name: string;
+  resolver: IconLibraryResolver;
+}
+/**
+ * Returns a library from the registry.
+ */
+export declare const getIconLibrary: (name: string) => IconLibrary | undefined;
+/**
+ * Removes an icon library from the registry.
+ */
+export declare const unregisterIconLibrary: (name: string) => void;
+/**
+ * Adds an icon library to the registry or overrides an existing one.
+ */
+export declare const registerIconLibrary: (name: string, options: Except<IconLibrary, 'name'>) => void;
+//# sourceMappingURL=library.d.ts.map

package/dist/types/components/icon/request.d.ts

@@ -0,0 +1,12 @@
+interface IconRequestOk {
+  ok: true;
+  data: string;
+}
+interface IconRequestError {
+  ok: false;
+  data: undefined;
+}
+type IconRequest = IconRequestError | IconRequestOk;
+declare const requestIcon: (url: string) => Promise<IconRequest>;
+export default requestIcon;
+//# sourceMappingURL=request.d.ts.map

package/dist/types/components/icon/system-library.d.ts

@@ -0,0 +1,4 @@
+import type { IconLibrary } from './library';
+declare const systemLibrary: IconLibrary;
+export default systemLibrary;
+//# sourceMappingURL=system-library.d.ts.map

package/dist/types/components/inline-link/inline-link.d.ts

@@ -0,0 +1,208 @@
+import type { ComponentInterface } from '../../stencil-public-runtime';
+import type { LiteralUnion } from 'type-fest';
+export type Target = '_blank' | '_parent' | '_self' | '_top';
+/**
+ * `<qds-inline-link>` elements, with their `href` property, create a hyperlink
+ * to web pages, files, email addresses, locations in the same page, or
+ * anything else a URL can address.
+ *
+ * Content within each `<qds-inline-link>` *should* indicate the inline link's
+ * destination. If the `href` property is present, pressing the enter key while
+ * focused on the `<qds-inline-link>` element will activate it.
+ *
+ * @slot Content to display for the inline link.
+ * @see https://quartz.se.com/build/components/inline-link
+ */
+export declare class InlineLink implements ComponentInterface {
+  /**
+   * Prevents the inline link from being interacted with: it cannot be pressed
+   * or focused.
+   */
+  disabled: boolean;
+  /**
+   * Causes the browser to treat the linked URL as a download. Can be used with
+   * or without a `filename` value:
+   *
+   * - Without a value, the browser will suggest a filename/extension,
+   * generated from various sources:
+   *
+   *   - The
+   *   [`Content-Disposition`](https://developer.mozilla.org/docs/Web/HTTP/Headers/Content-Disposition)
+   *   HTTP header
+   *   - The final segment in the URL
+   *   [path](https://developer.mozilla.org/docs/Web/API/URL/pathname)
+   *   - The
+   *   [media type](https://developer.mozilla.org/docs/Glossary/MIME_type)
+   *   (from the
+   *   [`Content-Type`](https://developer.mozilla.org/docs/Web/HTTP/Headers/Content-Type)
+   *   header, the start of a
+   *   [`data:` URL](https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URLs),
+   *   or
+   *   [`Blob.type`](https://developer.mozilla.org/docs/Web/API/Blob/type)
+   *   for a
+   *   [`blob:` URL](https://developer.mozilla.org/docs/Web/API/URL/createObjectURL))
+   * - `filename`: defining a value suggests it as the filename. `/` and `\`
+   * characters are converted to underscores (`_`). Filesystems may forbid
+   * other characters in filenames, so browsers will adjust the suggested name
+   * if necessary.
+   *
+   * @webnative
+   */
+  readonly download?: boolean | string;
+  /**
+   * The URL that the inline link points to. Inline links are not restricted to
+   * HTTP-based URLs — they can use any URL scheme supported by browsers:
+   *
+   * - Sections of a page with document fragments
+   * - Specific text portions with
+   * [text fragments](https://developer.mozilla.org/docs/Web/Text_fragments)
+   * - Pieces of media files with media fragments
+   * - Telephone numbers with `tel:` URLs
+   * - Email addresses with `mailto:` URLs
+   * - While web browsers may not support other URL schemes, websites can with
+   * [`registerProtocolHandler()`](https://developer.mozilla.org/docs/Web/API/Navigator/registerProtocolHandler)
+   *
+   * @webnative
+   */
+  readonly href?: string;
+  /**
+   * Hints at the human language of the linked URL. No built-in functionality.
+   * Allowed values are the same as
+   * [the global `lang` attribute](https://developer.mozilla.org/docs/Web/HTML/Global_attributes/lang).
+   *
+   * @webnative
+   */
+  readonly hreflang?: string;
+  /**
+   * How much of the
+   * [referrer](https://developer.mozilla.org/docs/Web/HTTP/Headers/Referer)
+   * to send when following the inline link.
+   *
+   * - `no-referrer`: The
+   * [`Referer`](https://developer.mozilla.org/docs/Web/HTTP/Headers/Referer)
+   * header will not be sent.
+   * - `no-referrer-when-downgrade`: The
+   * [`Referer`](https://developer.mozilla.org/docs/Web/HTTP/Headers/Referer)
+   * header will not be sent to
+   * [origin](https://developer.mozilla.org/docs/Glossary/Origin)s
+   * without [TLS](https://developer.mozilla.org/docs/Glossary/TLS)
+   * ([HTTPS](https://developer.mozilla.org/docs/Glossary/HTTPS)).
+   * - `origin`: The sent referrer will be limited to the origin of the
+   * referring page: its
+   * [scheme](https://developer.mozilla.org/docs/Learn/Common_questions/What_is_a_URL),
+   * [host](https://developer.mozilla.org/docs/Glossary/Host), and
+   * [port](https://developer.mozilla.org/docs/Glossary/Port).
+   * - `origin-when-cross-origin`: The referrer sent to other origins will be
+   * limited to the scheme, the host, and the port. Navigations on the same
+   * origin will still include the path.
+   * - `same-origin`: A referrer will be sent for
+   * [same origin](https://developer.mozilla.org/docs/Glossary/Same-origin_policy),
+   * but cross-origin requests will contain no referrer information.
+   * - `strict-origin`: Only send the origin of the document as the referrer
+   * when the protocol security level stays the same (HTTPS→HTTPS), but don't
+   * send it to a less secure destination (HTTPS→HTTP).
+   * - `strict-origin-when-cross-origin` (default): Send a full URL when
+   * performing a same-origin request, only send the origin when the protocol
+   * security level stays the same (HTTPS→HTTPS), and send no header to a less
+   * secure destination (HTTPS→HTTP).
+   * - `unsafe-url`: The referrer will include the origin and the path (but not the
+   * [fragment](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hash),
+   * [password](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/password),
+   * or [username](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/username)).
+   * **This value is unsafe** because it leaks origins and paths from
+   * TLS-protected resources to insecure origins.
+   *
+   * @webnative
+   */
+  readonly referrerPolicy?: ReferrerPolicy;
+  /**
+   * The relationship of the linked URL as space-separated
+   * [link types](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel).
+   *
+   * The following list includes some of the most important existing keywords.
+   * Every keyword within a space-separated value should be unique within that
+   * value.
+   *
+   * - [`alternate`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-alternate):
+   * Alternate representations of the current document.
+   * - [`author`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-author):
+   * Author of the current document or article.
+   * - [`bookmark`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-bookmark):
+   * Permalink for the nearest ancestor section.
+   * - [`external`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-external):
+   * The referenced document is not part of the same site as the current
+   * document. An icon will be rendered next to the text if this value is
+   * specified.
+   * - [`help`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-help):
+   * Link to context-sensitive help.
+   * - [`license`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-license):
+   * Indicates that the main content of the current document is covered by the
+   * copyright license described by the referenced document.
+   * - [`me`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel/me):
+   * Indicates that the current document represents the person who owns the
+   * linked content.
+   * - [`next`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-next):
+   * Indicates that the current document is a part of a series and that the
+   * next document in the series is the referenced document.
+   * - [`nofollow`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-nofollow):
+   * Indicates that the current document's original author or publisher does
+   * not endorse the referenced document.
+   * - [`noopener`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel/noopener):
+   * Creates a top-level browsing context that is not an auxiliary browsing
+   * context if the hyperlink would create either of those, to begin with (i.e.,
+   * has an appropriate `target` attribute value).
+   * - [`noreferrer`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-noreferrer):
+   * No `Referer` header will be included. Additionally, has the same effect as
+   * `noopener`.
+   * - [`opener`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-opener):
+   * Creates an auxiliary browsing context if the hyperlink would otherwise
+   * create a top-level browsing context that is not an auxiliary browsing
+   * context (i.e., has "`_blank`" as `target` attribute value).
+   * - [`prev`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-prev):
+   * Indicates that the current document is a part of a series and that the
+   * previous document in the series is the referenced document.
+   * - [`search`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-search):
+   * Gives a link to a resource that can be used to search through the current
+   * document and its related pages.
+   * - [`tag`](https://developer.mozilla.org/docs/Web/HTML/Attributes/rel#attr-tag):
+   * Gives a tag (identified by the given address) that applies to the current
+   * document.
+   *
+   * @webnative
+   */
+  readonly rel?: string;
+  /**
+   * Where to display the linked URL, as the name for a browsing context (a
+   * tab, window, or
+   * [`<iframe>`](https://developer.mozilla.org/docs/Web/HTML/Element/iframe).
+   * The following keywords have special meanings for where to load the URL:
+   *
+   * - `_blank`: usually a new tab, but users can configure browsers to open a new
+   *   window instead.
+   * - `_parent`: the parent browsing context of the current one. If no parent,
+   *   behaves as `_self`.
+   * - `_self`: the current browsing context.
+   * - `_top`: the topmost browsing context (the "highest" context that's an
+   *   ancestor of the current one). If no ancestors, behaves as `_self`.
+   *
+   * @webnative
+   */
+  readonly target: LiteralUnion<Target, string>;
+  /**
+   * Emitted when the inline link loses focus.
+   */
+  private readonly blurEmitter;
+  /**
+   * Emitted when the inline link gains focus.
+   */
+  private readonly focusEmitter;
+  private readonly element;
+  private inheritedAttributes;
+  private get computedTabIndex();
+  protected onClick(event: MouseEvent): void;
+  componentWillLoad(): void;
+  render(): any;
+  private readonly onBlur;
+  private readonly onFocus;
+}
+//# sourceMappingURL=inline-link.d.ts.map