@illinois-grad/grad-vue 7.0.0 → 7.1.1

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

@@ -127,10 +127,10 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     onMouseenter?: ((...args: any[]) => any) | undefined;
     onMouseleave?: ((...args: any[]) => any) | undefined;
 }>, {
-    size: "tiny" | "small" | "medium" | "large";
+    size: "medium" | "tiny" | "small" | "large";
     type: "button" | "submit" | "reset";
     text: boolean;
-    theme: "primary" | "secondary" | "accent" | "danger" | "none";
+    theme: "none" | "primary" | "secondary" | "danger" | "accent";
     outlined: boolean;
     disabled: boolean;
     to: string | Record<string, any>;

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

@@ -90,7 +90,7 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
 }> & Readonly<{
     onClose?: ((...args: any[]) => any) | undefined;
 }>, {
-    size: "small" | "medium" | "large" | "full";
+    size: "medium" | "small" | "large" | "full";
     describedby: string;
     hiddenLabel: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {

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

@@ -50,5 +50,5 @@ declare const __VLS_export: import("vue").DefineComponent<{
 }> & Readonly<{}>, {
     label: string;
     value: number;
-    size: "tiny" | "small" | "medium" | "large";
+    size: "medium" | "tiny" | "small" | "large";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -102,7 +102,7 @@ declare const __VLS_export: import("vue").DefineComponent<{
 }> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
 }>, {
-    size: "small" | "medium" | "large";
+    size: "medium" | "small" | "large";
     required: boolean;
     name: string;
     disabled: boolean;

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

@@ -115,7 +115,7 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     storageKey?: string;
 }> & Readonly<{}>, {
     width: string;
-    theme: "light" | "dark";
+    theme: "dark" | "light";
     sidebarKey: string;
     backgroundColor: string;
     backgroundImage: string;

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

@@ -141,7 +141,7 @@ declare const __VLS_export: import("vue").DefineComponent<{
 }> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
 }>, {
-    theme: "light" | "dark";
+    theme: "dark" | "light";
     compact: boolean;
     offset: number;
     spy: boolean;

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

@@ -38,7 +38,8 @@ export interface BulkAction {
  *     `filter.key` is omitted. Pass a filter/request type as the third
  *     `TableColumn` type argument to type-check `filter.key` and values, and
  *     use `buildFilterRequest()` to convert filter state into request values
- *     (for example `match: "contains"` produces `%text%`).
+ *     (for example `match: "contains"` produces `%text%`). `filterDefaults()`
+ *     builds the initial filter state from the same columns.
  *   - `display` accepts a custom render function for the column data.
  *   - `trClass` and `tdClass` can be used to provide custom classes for table rows and cells.
  * - `data` array with objects containing fields for the columns.

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

@@ -118,8 +118,8 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      */
     smallHeading?: boolean;
 }> & Readonly<{}>, {
-    theme: "light" | "dark";
-    listType: "ul" | "ol";
+    theme: "dark" | "light";
+    listType: "ol" | "ul";
     showExpandAll: boolean;
     headingLevel: "h2" | "h3";
     smallHeading: boolean;

package/dist/components/table/TableColumn.d.ts

@@ -106,7 +106,21 @@ export type SearchColumnFilter<F = AnyFilterRecord, K extends FilterKey<F> = Fil
 } & SearchFilterMapping<F, K>;
 /**
  * A single-select filter. Without `transform`, option values must match the
- * request field's type.
+ * request field's type. `0` and `false` are valid option values.
+ *
+ * For a "has value / has no value" filter on a nullable field, use boolean
+ * options with a boolean request key; clearing the select removes the filter:
+ *
+ * ```ts
+ * filter: {
+ *     type: "select",
+ *     key: "deposit_date__notnull",
+ *     options: [
+ *         { label: "Has Deposit Date", value: true },
+ *         { label: "No Deposit Date", value: false },
+ *     ],
+ * }
+ * ```
  */
 export type SelectColumnFilter<F = AnyFilterRecord, K extends FilterKey<F> = FilterKey<F>> = SelectFilterBase & {
     key?: K;

package/dist/components/tree-menu/GTreeMenuList.vue.d.ts

@@ -17,7 +17,7 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      */
     listType?: "ul" | "ol";
 }> & Readonly<{}>, {
-    listType: "ul" | "ol";
+    listType: "ol" | "ul";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     default?: (props: {}) => any;
 }>;

package/dist/compose/useFiltering.d.ts

@@ -32,7 +32,15 @@ export type FilterLocationQuery = {
 export interface FilteringOptions {
     syncWith?: Ref<FilterRouteQuery>;
 }
-export interface QueryFilteringOptions<F = AnyFilterRecord> {
+export interface FilterStateFromQueryOptions<F = AnyFilterRecord> {
+    /**
+     * Array filters whose `"true"`/`"false"` query values should be
+     * converted to booleans. Not needed for column filters with boolean
+     * option values, since `buildFilterRequest()` matches those itself.
+     */
+    booleanArrayKeys?: readonly FilterKey<F>[];
+}
+export interface QueryFilteringOptions<F = AnyFilterRecord> extends FilterStateFromQueryOptions<F> {
     route: {
         query: FilterRouteQuery;
     };
@@ -41,7 +49,6 @@ export interface QueryFilteringOptions<F = AnyFilterRecord> {
             query: FilterLocationQuery;
         }) => unknown;
     };
-    booleanArrayKeys?: readonly FilterKey<F>[];
 }
 /**
  * Represents a type that defines a set of filters for a given record type.
@@ -101,6 +108,37 @@ export declare function parseQueryArrayValue(value: FilterRouteQueryValue | Filt
  * ```
  */
 export declare function buildFilterRequest<T extends TableRow, F>(columns: readonly TableColumn<T, ColumnKey<T>, F>[], filters: FilterState<F>): FilterRequest<F>;
+/**
+ * Builds the default filter state for `useFiltering()` / `useQueryFiltering()`
+ * from column filter configuration, so filters don't have to be listed twice.
+ *
+ * Each filtered column adds its filter key (`filter.key ?? column.key`).
+ * Multi-select filters default to `[]`, so their query params are always read
+ * as arrays; all other filters default to `undefined`.
+ *
+ * @example
+ * ```ts
+ * const filtering = useQueryFiltering<StudentRow, Query>(filterDefaults(columns), { route, router });
+ * ```
+ */
+export declare function filterDefaults<T extends TableRow, F>(columns: readonly TableColumn<T, ColumnKey<T>, F>[]): FilterState<F>;
+/**
+ * Reads filter state from route query params, the same way
+ * `useQueryFiltering()` does, without creating reactive state or writing to
+ * the URL.
+ *
+ * Use this when another view needs the filters of a query-synced table, for
+ * example a detail page that loads the same list. Keys come from `defaults`;
+ * filters with array defaults are always read as arrays.
+ *
+ * @example
+ * ```ts
+ * const request = computed(() =>
+ *     buildFilterRequest(columns, filterStateFromQuery(filterDefaults(columns), route.query)),
+ * );
+ * ```
+ */
+export declare function filterStateFromQuery<F>(defaults: FilterState<F>, query: FilterRouteQuery, options?: FilterStateFromQueryOptions<F>): FilterState<F>;
 /**
  * Converts filter criteria into a format suitable for use as a query object
  * in vue-router.
@@ -123,6 +161,9 @@ export declare function filtersToQueryParams<T extends Record<string, any>>(filt
  * read from and written to query params as arrays, and `booleanArrayKeys` can
  * be used for multi-value filters that should be converted to boolean values
  * inside the filter state.
+ *
+ * Use `filterDefaults(columns)` to build `filters` from column configuration,
+ * and `filterStateFromQuery()` to read the same state elsewhere without syncing.
  */
 export declare function useQueryFiltering<T extends object = AnyFilterRecord, F = Partial<Record<keyof T, any>>>(filters: FilterState<F>, options: QueryFilteringOptions<F>): UseFilteringReturn<T, F>;
 /**