@mythpe/quasar-ui-qui 0.2.43 → 0.2.44

package/src/types/api/MInput.d.ts

@@ -0,0 +1,159 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { QFieldSlots, QIconProps, QInputProps, QInputSlots } from 'quasar'
+import type { MaybeRefOrGetter, UnwrapNestedRefs, VNode } from 'vue'
+import type { MColProps } from './MCol'
+import type { FieldContext, FieldOptions } from 'vee-validate'
+
+export type BaseInputFieldPropContext = FieldContext<any>
+export type BaseInputFieldProps = {
+  /**
+   * Context of field input.
+   */
+  field: UnwrapNestedRefs<BaseInputFieldPropContext>;
+  label?: string | undefined;
+}
+export type ViewModeProps = {
+  /**
+   * Set input to vie mode use q-field
+   */
+  viewMode?: boolean;
+  /**
+   * View Mode value for input or modelValue.
+   */
+  viewModeValue?: any | undefined;
+}
+export type InputHelpProps = {
+  /**
+   * Information text with Icon.
+   */
+  help?: string;
+}
+export type InputHelpSlots = {
+  /**
+   * VNode bottom of input & before 'bottom-input slot'.
+   */
+  help: () => VNode[];
+}
+export type InputRulesContext = string | string[] | Record<string, any> | undefined;
+export type InputErrorsContext = string[];
+export type InputFormErrorsContext = Record<string, InputErrorsContext> | undefined;
+export type BaseInputFormProps = {
+  /**
+   * Input name.
+   */
+  name: string;
+  /**
+   * Input model value.
+   * can be used instead of initialValue.
+   */
+  modelValue?: any;
+  /**
+   * Input Label.
+   */
+  label?: string | null;
+  /**
+   * Caption under label.
+   */
+  caption?: string | undefined;
+  /**
+   * Input Hint.
+   */
+  hint?: string | undefined;
+  /**
+   * Input Placeholder.
+   */
+  placeholder?: string | undefined;
+  /**
+   * Input Required validation.
+   */
+  required?: boolean;
+  /**
+   * Input Validation Rules.
+   */
+  rules?: InputRulesContext;
+  /**
+   * Input Error Messages.
+   */
+  // errors?: InputErrorsContext;
+  /**
+   * Form Error Messages.
+   */
+  // formErrors?: InputFormErrorsContext;
+  /**
+   * Input autocomplete attribute.
+   * if true, will set from input name.
+   * if false, will set 'off'.
+   * else, will set the attribute value.
+   * Default: undefined.
+   */
+  autocomplete?: boolean | string | undefined;
+  /**
+   * Inputs Top Label.
+   */
+  topLabel?: boolean;
+  /**
+   * Mobile Rule.
+   */
+  mobile?: boolean | string | number | ((value: unknown) => number | undefined) | undefined;
+  /**
+   * Email Rule.
+   */
+  email?: boolean;
+  /**
+   * Number Rule.
+   */
+  float?: boolean;
+  /**
+   * vee-validate Field Options.
+   */
+  fieldOptions?: Partial<FieldOptions> | MaybeRefOrGetter<Partial<FieldOptions>>;
+  /**
+   * choice key of auto placeholder.
+   */
+  useChoice?: boolean | string;
+  prependIcon?: string;
+  prependIconProps?: Partial<QIconProps>;
+  appendIcon?: string;
+  appendIconProps?: Partial<QIconProps>;
+}
+export type BaseInputsProps = ViewModeProps & InputHelpProps & Omit<MColProps, 'name'> & BaseInputFormProps
+export type BaseInputsSlots = InputHelpSlots & {
+  /**
+   * VNode top of input & top of 'top label slot'.
+   */
+  'top-input': () => VNode[];
+  /**
+   * The label top on input
+   */
+  'top-label': () => VNode[];
+  /**
+   * VNode top of input & after top label.
+   */
+  caption: () => VNode[];
+  /**
+   * Field main content
+   */
+  default: () => VNode[];
+  /**
+   * VNode bottom of input.
+   */
+  'bottom-input': () => VNode[];
+}
+export declare type GenericFormValues = Record<any, any>;
+
+export interface MInputProps extends Omit<QInputProps, 'rules' | 'name' | 'modelValue' | 'label' | 'hint'>, BaseInputsProps {
+  sar?: boolean;
+  prependIcon?: string;
+  prependIconProps?: Partial<QIconProps>;
+  appendIcon?: string;
+  appendIconProps?: Partial<QIconProps>;
+}
+
+export type MInputSlots = QInputSlots & QFieldSlots & BaseInputsSlots

package/src/types/api/MInputFieldControl.d.ts

@@ -0,0 +1,16 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { VNode } from 'vue'
+
+export type MInputFieldControlProps = {
+  [k: string]: any;
+}
+export type MInputFieldControlSlots = {
+  default: () => VNode[];
+}

package/src/types/api/MInputLabel.d.ts

@@ -0,0 +1,17 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { VNode } from 'vue'
+
+import type { BaseInputFieldProps } from './MInput'
+
+export type MInputLabelProps = BaseInputFieldProps
+export type MInputLabelSlots = {
+  before?: () => VNode[];
+  default?: () => VNode[];
+}

package/src/types/api/MMap.d.ts

@@ -0,0 +1,24 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { VNode } from 'vue'
+
+export interface MMapProps {
+  language?: 'ar' | 'en';
+  width?: string | number;
+  height?: string | number;
+  zoom?: string | number;
+  // mapProps?:
+}
+
+export interface MMapSlots {
+  /**
+   * Default main content
+   */
+  default: () => VNode[];
+}

package/src/types/api/MModalMenu.d.ts

@@ -0,0 +1,17 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { VNode } from 'vue'
+import type { QDialogProps, QMenuProps, QPopupProxyProps } from 'quasar'
+
+export type MModalMenuProps = Partial<QDialogProps> & Partial<QMenuProps> & Partial<QPopupProxyProps> & {
+  noCloseBtn?: boolean;
+}
+export type MModalMenuSlots = {
+  default: () => VNode[];
+}

package/src/types/api/MOptions.d.ts

@@ -0,0 +1,62 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { QCheckboxProps, QFieldSlots, QOptionGroupProps, QOptionGroupSlots, QRadioProps, QToggleProps } from 'quasar'
+import type { ApiInterface } from '../api-helpers'
+import type { BaseInputsProps, BaseInputsSlots } from './MInput'
+
+export interface MOptionsOptionContext extends Omit<QToggleProps, 'modelValue'>, Omit<QRadioProps, 'modelValue'>, Omit<QCheckboxProps, 'modelValue'> {
+  /**
+   * Label to display along the component
+   */
+  label: string;
+  /**
+   * Value of the option that will be used by the component model
+   */
+  value: any;
+  /**
+   * If true, the option will be disabled
+   */
+  disable?: boolean;
+
+  /**
+   * Any other props from QToggle & QCheckbox, or QRadio
+   */
+  [key: string]: any;
+}
+
+export type MOptionsProps = Omit<QOptionGroupProps, 'name' | 'modelValue' | 'options'> &
+  Omit<BaseInputsProps, 'autocomplete' | 'modelValue'> & {
+  modelValue?: any;
+  /**
+   * Array of objects with value, label, and disable (optional) props. The binary components will be created according to this array; Props from QToggle & QCheckbox or QRadio can also be added as key/value pairs to control the components singularly
+   */
+  options?: MOptionsOptionContext[];
+  /**
+   * Used auto static index myth api helpers.
+   */
+  guest?: boolean | undefined;
+  /**
+   * Get options by function. any send the current value to this function to get options.
+   */
+  service?: ((value?: any) => Promise<ApiInterface>) | string;
+  /**
+   * Service loading.
+   */
+  loading?: boolean | undefined;
+  /**
+   * Set content to be full width.
+   */
+  fullWidth?: boolean;
+  /**
+   * Set the width of content to be equal.
+   * Default is: 33.33333333%
+   */
+  fitWidth?: boolean;
+}
+export type MOptionsSlots = QOptionGroupSlots & QFieldSlots & BaseInputsSlots

package/src/types/api/MOtp.d.ts

@@ -0,0 +1,52 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { QInputProps, QInputSlots } from 'quasar'
+import type { VNode } from 'vue'
+
+export type MOtpProps = Omit<QInputProps, 'modelValue'> & {
+  /**
+   * Value of input after typing all inputs.
+   */
+  modelValue?: any;
+  /**
+   * Length of inputs.
+   */
+  inputLength?: string | number;
+  /**
+   * Values is string not number.
+   */
+  string?: boolean;
+  /**
+   * Resend time countdown in seconds.
+   */
+  time?: string | number;
+  /**
+   * Don't use timing to resend code.
+   */
+  noTiming?: boolean;
+  /**
+   * Don't use send again button.
+   */
+  noSendAgain?: boolean;
+  /**
+   * Top input label.
+   */
+  topLabel?: string | undefined;
+  /**
+   * Top input props.
+   */
+  topLabelProps?: any | undefined;
+  errors?: string[];
+}
+export type MOtpSlots = QInputSlots & {
+  default: () => VNode[];
+  'before-all': () => VNode[];
+  'after-all': () => VNode[];
+  'after-input': () => VNode[];
+}

package/src/types/api/MPassword.d.ts

@@ -0,0 +1,20 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { MInputProps } from './MInput'
+
+export type MPasswordProps = MInputProps & {
+  /**
+   * icon prepend it to password input.
+   */
+  icon?: boolean | undefined;
+  /**
+   * toggle password append icon.
+   */
+  noToggle?: boolean | undefined;
+}

package/src/types/api/MPicker.d.ts

@@ -0,0 +1,41 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { QBtnProps, QDateProps, QIconProps, QTimeProps } from 'quasar'
+import type { BaseInputsProps, MInputSlots } from './MInput'
+
+export interface MPickerProps extends BaseInputsProps, Omit<QDateProps, 'modelValue' | 'options'>, Omit<QTimeProps, 'modelValue'> {
+  /**
+   * Initial value of the picker.
+   * Default is: null.
+   */
+  modelValue?: string | any[] | any | null | undefined;
+  /**
+   * Type of picker. 'date' or 'time'.
+   * Default is: 'date'.
+   */
+  type?: 'date' | 'time';
+  /**
+   *  QBtn props for append button.
+   */
+  btnProps?: QBtnProps;
+  /**
+   * Value of separator for range picker.
+   * Default is: ' - '.
+   */
+  rangeSeparator?: string;
+  /**
+   * User long days & months names.
+   * Only work for 'date' type.
+   */
+  noDefaultLocale?: boolean;
+  prependIcon?: string;
+  prependIconProps?: Partial<QIconProps>;
+}
+
+export type MPickerSlots = MInputSlots

package/src/types/api/MRadio.d.ts

@@ -0,0 +1,13 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { QRadioProps } from 'quasar'
+import type { BaseCheckboxProps, MCheckboxSlots } from './MCheckbox'
+
+export type MRadioProps = Omit<QRadioProps, 'name' | 'modelValue' | 'label'> & BaseCheckboxProps
+export type MRadioSlots = MCheckboxSlots

package/src/types/api/MRow.d.ts

@@ -0,0 +1,24 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { ThemeSize } from '../theme'
+import type { VNode } from 'vue'
+
+export type MRowProps = {
+  /**
+   * Default: false.
+   */
+  gutter?: boolean | ThemeSize | undefined;
+  /**
+   * Default: false.
+   */
+  col?: boolean | ThemeSize | undefined;
+}
+export type MRowSlots = {
+  default?: () => VNode[];
+}

package/src/types/api/MSar.d.ts

@@ -0,0 +1,25 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { VNode } from 'vue'
+import type { QIconProps } from 'quasar'
+
+export type MSarIconProps = Omit<QIconProps, 'name'> & Record<string, any>;
+
+export interface MSarIconSlots {
+  default: () => VNode[]
+}
+
+export type MSarStringProps = {
+  text?: any;
+  string?: boolean;
+}
+
+export interface MSarStringSlots {
+  default: () => VNode[]
+}

package/src/types/api/MSelect.d.ts

@@ -1,6 +1,6 @@
 import type { QFieldSlots, QSelectProps, QSelectSlots } from 'quasar'
-import type { BaseInputsProps, BaseInputsSlots } from '../components'
 import type { VNode } from 'vue'
+import type { BaseInputsProps, BaseInputsSlots } from './MInput'
 
 export interface MSelectModelEmit {
   value: any | null;

package/src/types/api/MSignaturePad.d.ts

@@ -1,5 +1,6 @@
-import type { BaseInputsProps, MColProps } from '../components'
 import type { VNode } from 'vue'
+import type { MColProps } from './MCol'
+import type { BaseInputsProps } from './MInput'
 
 export interface SignaturePadWaterMark {
   /**

package/src/types/api/MTime.d.ts

@@ -0,0 +1,12 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { MPickerProps, MPickerSlots } from './MPicker'
+
+export type MTimeProps = Omit<MPickerProps, 'type'>
+export type MTimeSlots = MPickerSlots

package/src/types/api/MToggle.d.ts

@@ -0,0 +1,39 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { QToggleProps } from 'quasar'
+import type { MCheckboxSlots } from './MCheckbox'
+import type { BaseInputsProps } from './MInput'
+
+export type MToggleProps = Omit<BaseInputsProps, 'placeholder' | 'topLabel' | 'autocomplete' | 'modelValue'> &
+  Omit<QToggleProps, 'modelValue' | 'label' | 'name'> & {
+  modelValue?: any;
+  /**
+   * Customize the label when the toggle is true.
+   * Default is: Yes.
+   */
+  activeLabel?: string;
+  /**
+   * Customize the label when the toggle is false.
+   * Default is: No.
+   */
+  inactiveLabel?: string;
+  /**
+   * Set labels of toggle to status, Active & Inactive.
+   */
+  status?: boolean;
+  /**
+   * Input row props.
+   */
+  rowProps?: Record<string, any>;
+  /**
+   * Input column props.
+   */
+  colProps?: Record<string, any>;
+}
+export type MToggleSlots = MCheckboxSlots & Pick<BaseInputsProps, 'topLabel'>

package/src/types/api/MTooltip.d.ts

@@ -0,0 +1,136 @@
+/*
+ * MyTh Ahmed Faiz Copyright © 2016-2025 All rights reserved.
+ * Email: mythpe@gmail.com
+ * Mobile: +966590470092
+ * Website: https://www.4myth.com
+ * Github: https://github.com/mythpe
+ */
+
+import type { QTooltipProps } from 'quasar'
+import type { VNode } from 'vue'
+
+export type MTooltipProps = Partial<QTooltipProps> & {
+  /**
+   * One of Quasar's embedded transitions
+   * Default value: jump-down
+   */
+  transitionShow?: string | undefined;
+  /**
+   * One of Quasar's embedded transitions
+   * Default value: jump-up
+   */
+  transitionHide?: string | undefined;
+  /**
+   * Transition duration (in milliseconds, without unit)
+   * Default value: 300
+   */
+  transitionDuration?: string | number | undefined;
+  /**
+   * Model of the component defining shown/hidden state; Either use this property (along with a listener for 'update:model-value' event) OR use v-model directive
+   */
+  modelValue?: boolean;
+  /**
+   * The maximum height of the Tooltip; Size in CSS units, including unit name
+   */
+  maxHeight?: string | undefined;
+  /**
+   * The maximum width of the Tooltip; Size in CSS units, including unit name
+   */
+  maxWidth?: string | undefined;
+  /**
+   * Two values setting the starting position or anchor point of the Tooltip relative to its target
+   * Default value: bottom middle
+   */
+  anchor?:
+    | 'top left'
+    | 'top middle'
+    | 'top right'
+    | 'top start'
+    | 'top end'
+    | 'center left'
+    | 'center middle'
+    | 'center right'
+    | 'center start'
+    | 'center end'
+    | 'bottom left'
+    | 'bottom middle'
+    | 'bottom right'
+    | 'bottom start'
+    | 'bottom end'
+    | undefined;
+  /**
+   * Two values setting the Tooltip's own position relative to its target
+   * Default value: top middle
+   */
+  self?:
+    | 'top left'
+    | 'top middle'
+    | 'top right'
+    | 'top start'
+    | 'top end'
+    | 'center left'
+    | 'center middle'
+    | 'center right'
+    | 'center start'
+    | 'center end'
+    | 'bottom left'
+    | 'bottom middle'
+    | 'bottom right'
+    | 'bottom start'
+    | 'bottom end'
+    | undefined;
+  /**
+   * An array of two numbers to offset the Tooltip horizontally and vertically in pixels
+   * Default value: [14, 14]
+   */
+  offset?: readonly any[] | undefined;
+  /**
+   * CSS selector or DOM element to be used as a custom scroll container instead of the auto detected one
+   */
+  scrollTarget?: Element | string | undefined;
+  /**
+   * Configure a target element to trigger Tooltip toggle; 'true' means it enables the parent DOM element, 'false' means it disables attaching events to any DOM elements; By using a String (CSS selector) it attaches the events to the specified DOM element (if it exists)
+   * Default value: true
+   */
+  target?: boolean | string | undefined;
+  /**
+   * Skips attaching events to the target DOM element (that trigger the element to get shown)
+   */
+  noParentEvent?: boolean | undefined;
+  /**
+   * Configure Tooltip to appear with delay
+   */
+  delay?: number | undefined;
+  /**
+   * Configure Tooltip to disappear with delay
+   */
+  hideDelay?: number | undefined;
+  /**
+   * Emitted when showing/hidden state changes; Is also used by v-model
+   * @param value New state (showing/hidden)
+   */
+  'onUpdate:modelValue'?: (value: boolean) => void;
+  /**
+   * Emitted after component has triggered show()
+   * @param evt JS event object
+   */
+  onShow?: (evt: Event) => void;
+  /**
+   * Emitted when component triggers show() but before it finishes doing it
+   * @param evt JS event object
+   */
+  onBeforeShow?: (evt: Event) => void;
+  /**
+   * Emitted after component has triggered hide()
+   * @param evt JS event object
+   */
+  onHide?: (evt: Event) => void;
+  /**
+   * Emitted when component triggers hide() but before it finishes doing it
+   * @param evt JS event object
+   */
+  onBeforeHide?: (evt: Event) => void;
+}
+export type MTooltipSlots = {
+  default: () => VNode[];
+}