@ac-design/design-system 2.6.1 → 2.7.0

package/dist/lib/components/AcMonthPicker.js

@@ -0,0 +1,5 @@
+import e from "./AcMonthPicker.vue_vue_type_script_setup_true_lang.js";
+//#region src/lib/components/AcMonthPicker.vue
+var t = e;
+//#endregion
+export { t as default };

package/dist/lib/components/AcMonthPicker.vue.d.ts

@@ -0,0 +1,102 @@
+import type { HTMLAttributes } from "vue";
+export interface MonthPickerPreset {
+    /** Button text, e.g. "Last 6 months". */
+    label: string;
+    /** Returns the value in the same format as `v-model`: `YYYY-MM`, or `[start, end]` with `range`. */
+    value: () => string | [string, string];
+}
+export interface Props {
+    /** Label above the field. Doubles as the accessible name of the trigger and the popover. */
+    label?: string;
+    /** Text shown in the field while there's no value. Defaults to "Choose month" (or "Choose months" with `range`). */
+    placeholder?: string;
+    /** Pick a start and an end month; `v-model` becomes `[start, end]`, swapped so start ≤ end. */
+    range?: boolean;
+    /** Earliest choosable month as `YYYY-MM`; a `YYYY-MM-DD` uses its month. */
+    minMonth?: string;
+    /** Latest choosable month as `YYYY-MM`; a `YYYY-MM-DD` uses its month. */
+    maxMonth?: string;
+    /** Old `min-date`: the same as `minMonth`, which wins when both are set. */
+    minDate?: string;
+    /** Old `max-date`: the same as `maxMonth`, which wins when both are set. */
+    maxDate?: string;
+    /** Return `true` to block a month. It receives the month as `YYYY-MM`. */
+    isMonthDisabled?: (month: string) => boolean;
+    /** Quick picks shown beside the grid, such as “Last 6 months”. Choosing one applies it at once. */
+    presets?: MonthPickerPreset[];
+    /** BCP 47 locale for month names and the field text, e.g. "March 2026". Defaults to the browser's. */
+    locale?: string;
+    /** Shows a clear button in the field, and a Clear button in the popover, when there is a value. */
+    clearable?: boolean;
+    /** Disables the field. */
+    disabled?: boolean;
+    /** Marks the field required and adds a red asterisk. */
+    required?: boolean;
+    /** Error text under the field. Turns the border red and sets `aria-invalid`. */
+    errorMsg?: string;
+    /** Help text between the label and the field. */
+    hint?: string;
+    /** `small` 36px or `normal` 42px tall, the same as `AcInput`; `large` is 50px with 16px medium text, as `AcDatePicker`. */
+    size?: "small" | "normal" | "large";
+    /** Adds a hidden input with this name so plain form posts include the value. A range posts as `start/end`. */
+    name?: string;
+    /** Draws the month grid in place, with no field, popover or border. Each pick updates `v-model` at once. */
+    inline?: boolean;
+    /** Shape of `v-model`: `string` for `YYYY-MM`, or `date` for a `Date` at local midnight on the 1st. Not for `range`. */
+    valueType?: "string" | "date";
+    /** Classes for the field box under the label, e.g. `max-w-xs` to keep it narrower than the hint. */
+    fieldClass?: HTMLAttributes["class"];
+}
+type __VLS_Props = Props;
+type __VLS_Slots = {
+    /** Content before the label text, such as a 14px icon. */
+    "label-icon"?: () => unknown;
+    /** Content after the label text, such as "(Optional)" or an info tooltip. */
+    "label-extra"?: () => unknown;
+};
+type __VLS_ModelProps = {
+    /** `"2026-03"`, or `[start, end]` with `range`; a `Date` with `value-type="date"`. `null` when empty. */
+    modelValue?: string | Date | [string, string] | null;
+    /** Whether the popover is open. */
+    "open"?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    /** Moves focus to the field, or to the grid's current month when `inline`. */
+    focus: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | Date | [string, string] | null) => any;
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | Date | [string, string] | null) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    required: boolean;
+    label: string;
+    disabled: boolean;
+    name: string;
+    size: "small" | "normal" | "large";
+    hint: string;
+    inline: boolean;
+    placeholder: string;
+    errorMsg: string;
+    range: boolean;
+    clearable: boolean;
+    presets: MonthPickerPreset[];
+    locale: string;
+    minDate: string;
+    maxDate: string;
+    valueType: "string" | "date";
+    fieldClass: string | false | Record<string, any> | import("vue").ClassValue[] | null;
+    minMonth: string;
+    maxMonth: string;
+    isMonthDisabled: (month: string) => boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};