@illinois-grad/grad-vue 2.5.0 → 2.5.2

package/dist/components/GSubmitButton.vue.d.ts

@@ -5,6 +5,10 @@
  * - Show a loading state during form submission
  * - Be disabled when specified
  *
+ * In standard Vue usage, this resolves the nearest parent `GForm` via
+ * injection. In custom-elements mode, use matching `form-key` values to pair
+ * with a `GForm`.
+ *
  * @example
  * <GForm v-model="formData" @submit="handleSubmit">
  *   <GTextInput name="email" label="Email" />
@@ -29,6 +33,11 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * @demo
      */
     variant?: "primary" | "secondary" | "danger";
+    /**
+     * Form channel key for custom elements mode
+     * @demo
+     */
+    formKey?: string;
 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
     /**
      * Disabled state
@@ -45,7 +54,13 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * @demo
      */
     variant?: "primary" | "secondary" | "danger";
+    /**
+     * Form channel key for custom elements mode
+     * @demo
+     */
+    formKey?: string;
 }> & Readonly<{}>, {
+    formKey: string;
     disabled: boolean;
     variant: "primary" | "secondary" | "danger";
     loadingText: string;

package/dist/components/GTextInput.vue.d.ts

@@ -5,6 +5,10 @@
  * All non-prop attributes are passed through to the input element, including
  * `id`.
  *
+ * In standard Vue usage, this registers with the nearest parent `GForm` via
+ * injection. In custom-elements mode, use matching `form-key` values to pair
+ * with a `GForm`.
+ *
  * Errors are provided as an array of strings or computed values.
  * Multiple errors will all be displayed.
  */
@@ -54,6 +58,10 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * Name for form registration
      */
     name?: string;
+    /**
+     * Form channel key for custom elements mode
+     */
+    formKey?: string;
 } & {
     modelValue?: string | null;
 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -106,6 +114,10 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * Name for form registration
      */
     name?: string;
+    /**
+     * Form channel key for custom elements mode
+     */
+    formKey?: string;
 } & {
     modelValue?: string | null;
 }> & Readonly<{
@@ -118,9 +130,10 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     label: string;
     placeholder: string;
     name: string;
-    disabled: boolean;
-    errors: string[];
     instructions: string;
+    errors: string[];
+    formKey: string;
+    disabled: boolean;
     prefix: string;
     suffix: string;
     debounce: number;

package/dist/components/GTextarea.vue.d.ts

@@ -0,0 +1,170 @@
+/**
+ * A multi-line plain text input with styling for a label, instructions,
+ * and error messages.
+ *
+ * If `label` is omitted, an accessible label must be provided some other way.
+ * All non-prop attributes are passed through to the textarea element, including
+ * `id`.
+ *
+ * In standard Vue usage, this registers with the nearest parent `GForm` via
+ * injection. In custom-elements mode, use matching `form-key` values to pair
+ * with a `GForm`.
+ *
+ * Errors are provided as an array of strings or computed values.
+ * Multiple errors will all be displayed.
+ */
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+    /**
+     * Label
+     * @demo Example Label
+     */
+    label?: string;
+    /**
+     * Placeholder text
+     * @demo
+     */
+    placeholder?: string;
+    /**
+     * Disabled
+     * @demo
+     */
+    disabled?: boolean;
+    /**
+     * Read-only
+     * @demo
+     */
+    readonly?: boolean;
+    /**
+     * Required
+     * @demo
+     */
+    required?: boolean;
+    /**
+     * Error messages array (supports multiple validation errors)
+     */
+    errors?: string[];
+    /**
+     * Instructions
+     * @demo
+     */
+    instructions?: string;
+    /**
+     * Number of visible text rows
+     * @demo
+     */
+    rows?: number;
+    /**
+     * Maximum number of characters allowed
+     * @demo
+     */
+    maxlength?: number;
+    /**
+     * Automatically grow the textarea height to fit content
+     * @demo
+     */
+    autoGrow?: boolean;
+    /**
+     * Name for form registration
+     */
+    name?: string;
+    /**
+     * Form channel key for custom elements mode
+     */
+    formKey?: string;
+} & {
+    modelValue?: string | null;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | null | undefined) => any;
+    change: (args_0: {
+        was: string | null | undefined;
+        to: string | null;
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<{
+    /**
+     * Label
+     * @demo Example Label
+     */
+    label?: string;
+    /**
+     * Placeholder text
+     * @demo
+     */
+    placeholder?: string;
+    /**
+     * Disabled
+     * @demo
+     */
+    disabled?: boolean;
+    /**
+     * Read-only
+     * @demo
+     */
+    readonly?: boolean;
+    /**
+     * Required
+     * @demo
+     */
+    required?: boolean;
+    /**
+     * Error messages array (supports multiple validation errors)
+     */
+    errors?: string[];
+    /**
+     * Instructions
+     * @demo
+     */
+    instructions?: string;
+    /**
+     * Number of visible text rows
+     * @demo
+     */
+    rows?: number;
+    /**
+     * Maximum number of characters allowed
+     * @demo
+     */
+    maxlength?: number;
+    /**
+     * Automatically grow the textarea height to fit content
+     * @demo
+     */
+    autoGrow?: boolean;
+    /**
+     * Name for form registration
+     */
+    name?: string;
+    /**
+     * Form channel key for custom elements mode
+     */
+    formKey?: string;
+} & {
+    modelValue?: string | null;
+}> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | null | undefined) => any) | undefined;
+    onChange?: ((args_0: {
+        was: string | null | undefined;
+        to: string | null;
+    }) => any) | undefined;
+}>, {
+    label: string;
+    placeholder: string;
+    name: string;
+    instructions: string;
+    errors: string[];
+    required: boolean;
+    formKey: string;
+    disabled: boolean;
+    readonly: boolean;
+    rows: number;
+    maxlength: number;
+    autoGrow: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    instructions?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/GTooltip.vue.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Tooltip for concise contextual help text.
+ *
+ * The `trigger` slot is optional. Without a trigger slot, the tooltip anchors
+ * to the previous sibling element and can still be controlled via exposed
+ * methods.
+ */
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+    /**
+     * Tooltip text
+     * @demo
+     */
+    text: string;
+}, {
+    show: () => void;
+    hide: () => void;
+    toggle: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "tooltip-hide": (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<{
+    /**
+     * Tooltip text
+     * @demo
+     */
+    text: string;
+}> & Readonly<{
+    "onTooltip-hide"?: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
+    trigger?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/compose/tooltipDom.d.ts

@@ -0,0 +1,6 @@
+export declare function nextTooltipId(prefix?: string): string;
+export declare function resolveTooltipId(el: HTMLElement, prefix?: string): string;
+export declare function createTooltipEl(text: string, id: string): HTMLDivElement;
+export declare function appendTooltipEl(tooltip: HTMLElement): void;
+export declare function showTooltip(anchor: HTMLElement, tooltip: HTMLElement): void;
+export declare function hideTooltip(tooltip: HTMLElement): void;

package/dist/compose/useCustomElementAttrs.d.ts

@@ -0,0 +1,14 @@
+type UseCustomElementAttrsOptions = {
+    omitInCustomElement?: string[];
+};
+export declare function isCustomElementMode(): boolean;
+export declare function useCustomElementAttrs(options?: UseCustomElementAttrsOptions): {
+    attrs: {
+        [x: string]: unknown;
+    };
+    isCustomElement: boolean;
+    forwardedAttrs: import("vue").ComputedRef<{
+        [x: string]: unknown;
+    }>;
+};
+export {};

package/dist/compose/useFormField.d.ts

@@ -12,6 +12,10 @@ export interface UseFormFieldOptions {
      * Error messages from props (optional) - should be a reactive reference
      */
     errors?: Ref<string[]> | ComputedRef<string[]>;
+    /**
+     * Form channel key for custom elements mode
+     */
+    formKey?: string;
 }
 export interface UseFormFieldReturn {
     /**

package/dist/compose/useOverlayFocus.d.ts

@@ -1,6 +1,6 @@
 import { Ref } from "vue";
 export declare function useOverlayFocus(element: Ref<HTMLElement | null>, isTop: Ref<boolean>, clickOutsideDeactivates?: boolean): {
-    activate: (opts?: import("focus-trap").ActivateOptions) => void;
+    activate: () => void;
     deactivate: (opts?: import("focus-trap").DeactivateOptions) => void;
     pause: import("@vueuse/shared").Fn;
     unpause: import("@vueuse/shared").Fn;

package/dist/compose/useWebComponentForm.d.ts

@@ -0,0 +1,2 @@
+import { UseFormReturn } from "./useForm";
+export declare function useWebComponentForm(key?: string): UseFormReturn;

package/dist/compose/useWebComponentSidebar.d.ts

@@ -0,0 +1,9 @@
+import { Ref } from "vue";
+type SidebarChannel = {
+    id: string;
+    open: Ref<boolean>;
+    isCollapsible: Ref<boolean>;
+    toggle: () => void;
+};
+export declare function useWebComponentSidebar(key?: string, breakpoint?: Ref<string> | string): SidebarChannel;
+export {};