@qnc/qnc_data_tables 1.0.4 → 1.0.6-a

package/dist/table_options.d.ts

@@ -0,0 +1,164 @@
+import * as ss from "superstruct";
+declare const ColumnStruct: ss.Struct<{
+    key: string;
+    fixed: boolean;
+    display: string;
+    help_text: string;
+    enabled: boolean;
+    width: number;
+    sortable: boolean;
+}, {
+    /** used to persist settings in Storage; must be unique across a table */
+    key: ss.Struct<string, null>;
+    /** column title */
+    display: ss.Struct<string, null>;
+    help_text: ss.Struct<string, null>;
+    /** whether the column is _initially_ shown; user can enable/disable */
+    enabled: ss.Struct<boolean, null>;
+    /** if true, the column cannot be reordered or enabled/disabled by the user, and is "sticky" when scrolling horizontally */
+    fixed: ss.Struct<boolean, null>;
+    /** sets the _initial_ with, in px; it's user-resizable */
+    width: ss.Struct<number, null>;
+    /** whether or not the user can click the column header to sort by this column */
+    /** when the user is sorting by this column, we will automatically set sort key to column_asc-KEY or column-desc-KEY */
+    sortable: ss.Struct<boolean, null>;
+}>;
+export type Column = ss.Infer<typeof ColumnStruct>;
+declare const OptionalStorageStruct: ss.Struct<"localStorage" | "sessionStorage" | null, null>;
+export type OptionalStorageChoice = ss.Infer<typeof OptionalStorageStruct>;
+export declare function get_storage(type: OptionalStorageChoice): Storage | null;
+/**
+    "ExtraSortFunctions" are NOT js functions.
+    They are DESCRIPTIONS of sort functions implemented by the backend.
+    The only thing the front-end does with them is display some kind of sort-picker.
+ */
+declare const ExtraSortFunctionStruct: ss.Struct<{
+    key: string;
+    display: string;
+    help_text: string;
+}, {
+    /** will be submitted to back-end */
+    key: ss.Struct<string, null>;
+    /** what to display in sort-picker */
+    display: ss.Struct<string, null>;
+    /** help text, in case `display` is not self-explanatory */
+    help_text: ss.Struct<string, null>;
+}>;
+export type ExtraSortFunction = ss.Infer<typeof ExtraSortFunctionStruct>;
+declare const TableOptionsStruct: ss.Struct<{
+    columns: {
+        key: string;
+        fixed: boolean;
+        display: string;
+        help_text: string;
+        enabled: boolean;
+        width: number;
+        sortable: boolean;
+    }[];
+    allow_selection: boolean;
+    api_url: string;
+    filter_form_id: string;
+    key_prefix: string;
+    refresh_on_change: boolean;
+    page_size: number;
+    page_limit: number;
+    table_limit: number;
+    fill_last_page: boolean;
+    default_sort_key: string;
+    layout_storage: "localStorage" | "sessionStorage" | null;
+    navigation_storage: "localStorage" | "sessionStorage" | null;
+    selection_storage: "localStorage" | "sessionStorage" | null;
+    sort_storage: "localStorage" | "sessionStorage" | null;
+    extra_sort_functions: {
+        key: string;
+        display: string;
+        help_text: string;
+    }[];
+    default_sort: {
+        type: "column";
+        column_key: string;
+        direction: "reverse" | "forward";
+    } | {
+        type: "function";
+        function_key: string;
+    } | null;
+}, {
+    columns: ss.Struct<{
+        key: string;
+        fixed: boolean;
+        display: string;
+        help_text: string;
+        enabled: boolean;
+        width: number;
+        sortable: boolean;
+    }[], ss.Struct<{
+        key: string;
+        fixed: boolean;
+        display: string;
+        help_text: string;
+        enabled: boolean;
+        width: number;
+        sortable: boolean;
+    }, {
+        /** used to persist settings in Storage; must be unique across a table */
+        key: ss.Struct<string, null>;
+        /** column title */
+        display: ss.Struct<string, null>;
+        help_text: ss.Struct<string, null>;
+        /** whether the column is _initially_ shown; user can enable/disable */
+        enabled: ss.Struct<boolean, null>;
+        /** if true, the column cannot be reordered or enabled/disabled by the user, and is "sticky" when scrolling horizontally */
+        fixed: ss.Struct<boolean, null>;
+        /** sets the _initial_ with, in px; it's user-resizable */
+        width: ss.Struct<number, null>;
+        /** whether or not the user can click the column header to sort by this column */
+        /** when the user is sorting by this column, we will automatically set sort key to column_asc-KEY or column-desc-KEY */
+        sortable: ss.Struct<boolean, null>;
+    }>>;
+    allow_selection: ss.Struct<boolean, null>;
+    api_url: ss.Struct<string, null>;
+    filter_form_id: ss.Struct<string, null>;
+    key_prefix: ss.Struct<string, null>;
+    refresh_on_change: ss.Struct<boolean, null>;
+    page_size: ss.Struct<number, null>;
+    page_limit: ss.Struct<number, null>;
+    table_limit: ss.Struct<number, null>;
+    fill_last_page: ss.Struct<boolean, null>;
+    default_sort_key: ss.Struct<string, null>;
+    /** Where table layout preferences (columns, column widths) are stored */
+    layout_storage: ss.Struct<"localStorage" | "sessionStorage" | null, null>;
+    /** where page number is stored */
+    navigation_storage: ss.Struct<"localStorage" | "sessionStorage" | null, null>;
+    /** where selection is stored */
+    selection_storage: ss.Struct<"localStorage" | "sessionStorage" | null, null>;
+    /** where sort order is stored */
+    sort_storage: ss.Struct<"localStorage" | "sessionStorage" | null, null>;
+    /** when non-empty, will cause a "sort widget" to be displayed in the paginator */
+    extra_sort_functions: ss.Struct<{
+        key: string;
+        display: string;
+        help_text: string;
+    }[], ss.Struct<{
+        key: string;
+        display: string;
+        help_text: string;
+    }, {
+        /** will be submitted to back-end */
+        key: ss.Struct<string, null>;
+        /** what to display in sort-picker */
+        display: ss.Struct<string, null>;
+        /** help text, in case `display` is not self-explanatory */
+        help_text: ss.Struct<string, null>;
+    }>>;
+    default_sort: ss.Struct<{
+        type: "column";
+        column_key: string;
+        direction: "reverse" | "forward";
+    } | {
+        type: "function";
+        function_key: string;
+    } | null, null>;
+}>;
+export type TableOptions = ss.Infer<typeof TableOptionsStruct>;
+export declare function read_options_from_json_string(json: string): TableOptions;
+export {};

package/dist/table_options.js

@@ -0,0 +1,97 @@
+import * as ss from "superstruct";
+import { assert_never } from "@qnc/type_utils";
+function css_class_component() {
+    return ss.define("css_class_component", (value) => (typeof value == "string" && value.match(/^[\w-]*$/) !== null) ||
+        `Expected a string, but received: ${value}`);
+}
+const ColumnStruct = ss.object({
+    /** used to persist settings in Storage; must be unique across a table */
+    key: css_class_component(),
+    /** column title */
+    display: ss.string(),
+    help_text: ss.string(),
+    /** whether the column is _initially_ shown; user can enable/disable */
+    enabled: ss.boolean(),
+    /** if true, the column cannot be reordered or enabled/disabled by the user, and is "sticky" when scrolling horizontally */
+    fixed: ss.boolean(),
+    /** sets the _initial_ with, in px; it's user-resizable */
+    width: ss.number(),
+    /** whether or not the user can click the column header to sort by this column */
+    /** when the user is sorting by this column, we will automatically set sort key to column_asc-KEY or column-desc-KEY */
+    sortable: ss.boolean(),
+});
+const OptionalStorageStruct = ss.union([
+    ss.literal("localStorage"),
+    ss.literal("sessionStorage"),
+    ss.literal(null),
+]);
+export function get_storage(type) {
+    if (type == "localStorage")
+        return localStorage;
+    if (type == "sessionStorage")
+        return sessionStorage;
+    if (type == null)
+        return null;
+    assert_never(type);
+}
+const SortStateStruct = ss.union([
+    ss.object({
+        type: ss.literal("column"),
+        column_key: ss.string(),
+        direction: ss.union([ss.literal("forward"), ss.literal("reverse")]),
+    }),
+    ss.object({
+        type: ss.literal("function"),
+        function_key: ss.string(),
+    }),
+]);
+/**
+    "ExtraSortFunctions" are NOT js functions.
+    They are DESCRIPTIONS of sort functions implemented by the backend.
+    The only thing the front-end does with them is display some kind of sort-picker.
+ */
+const ExtraSortFunctionStruct = ss.object({
+    /** will be submitted to back-end */
+    key: ss.string(),
+    /** what to display in sort-picker */
+    display: ss.string(),
+    /** help text, in case `display` is not self-explanatory */
+    help_text: ss.defaulted(ss.string(), ""),
+});
+const TableOptionsStruct = ss.object({
+    columns: ss.array(ColumnStruct),
+    allow_selection: ss.defaulted(ss.boolean(), false),
+    api_url: ss.defaulted(ss.string(), "."),
+    // If non-empty, MUST reference a <form> element on the page
+    filter_form_id: ss.defaulted(ss.string(), ""),
+    // Must be unique across all data tables on a given page (used in constructing CSS classes and Storage keys)
+    // Must be unique across all tables submitting to same api_url (used in constructing keys for backend communication)
+    // Must contain only alphanumerics, underscores, and hyphens
+    key_prefix: ss.defaulted(css_class_component(), "table-manager"),
+    // if the table is associated with a filter form, it will refresh on submit events
+    // additionally, if this is set, the table will refresh on any change event on the form
+    refresh_on_change: ss.defaulted(ss.boolean(), true),
+    page_size: ss.integer(),
+    page_limit: ss.integer(),
+    table_limit: ss.integer(),
+    // If last page of data has fewer rows than page_size and this is set, we'll add empty rows
+    // keeps layout/height more consistent, regardless of data
+    fill_last_page: ss.defaulted(ss.boolean(), true),
+    // Initial sort key to pass to backend, if user has not chosen something else
+    // Empty string means "use first enabled sortable column"
+    default_sort_key: ss.defaulted(ss.string(), ""),
+    /** Where table layout preferences (columns, column widths) are stored */
+    layout_storage: ss.defaulted(OptionalStorageStruct, "localStorage"),
+    /** where page number is stored */
+    navigation_storage: ss.defaulted(OptionalStorageStruct, "sessionStorage"),
+    /** where selection is stored */
+    selection_storage: ss.defaulted(OptionalStorageStruct, "sessionStorage"),
+    /** where sort order is stored */
+    sort_storage: ss.defaulted(OptionalStorageStruct, "localStorage"),
+    /** when non-empty, will cause a "sort widget" to be displayed in the paginator */
+    extra_sort_functions: ss.defaulted(ss.array(ExtraSortFunctionStruct), []),
+    default_sort: ss.defaulted(ss.union([SortStateStruct, ss.literal(null)]), null),
+});
+export function read_options_from_json_string(json) {
+    return ss.create(JSON.parse(json), TableOptionsStruct);
+}

package/dist/table_options.ts

@@ -0,0 +1,132 @@
+import * as ss from "superstruct";
+import { assert_never } from "@qnc/type_utils";
+
+function css_class_component(): ss.Struct<string, null> {
+    return ss.define(
+        "css_class_component",
+        (value) =>
+            (typeof value == "string" && value.match(/^[\w-]*$/) !== null) ||
+            `Expected a string, but received: ${value}`,
+    );
+}
+
+const ColumnStruct = ss.object({
+    /** used to persist settings in Storage; must be unique across a table */
+    key: css_class_component(),
+
+    /** column title */
+    display: ss.string(),
+
+    help_text: ss.string(),
+
+    /** whether the column is _initially_ shown; user can enable/disable */
+    enabled: ss.boolean(),
+
+    /** if true, the column cannot be reordered or enabled/disabled by the user, and is "sticky" when scrolling horizontally */
+    fixed: ss.boolean(),
+
+    /** sets the _initial_ with, in px; it's user-resizable */
+    width: ss.number(),
+
+    /** whether or not the user can click the column header to sort by this column */
+    /** when the user is sorting by this column, we will automatically set sort key to column_asc-KEY or column-desc-KEY */
+    sortable: ss.boolean(),
+});
+export type Column = ss.Infer<typeof ColumnStruct>;
+
+const OptionalStorageStruct = ss.union([
+    ss.literal("localStorage"),
+    ss.literal("sessionStorage"),
+    ss.literal(null),
+]);
+export type OptionalStorageChoice = ss.Infer<typeof OptionalStorageStruct>;
+
+export function get_storage(type: OptionalStorageChoice): Storage | null {
+    if (type == "localStorage") return localStorage;
+    if (type == "sessionStorage") return sessionStorage;
+    if (type == null) return null;
+    assert_never(type);
+}
+
+const SortStateStruct = ss.union([
+    ss.object({
+        type: ss.literal("column"),
+        column_key: ss.string(),
+        direction: ss.union([ss.literal("forward"), ss.literal("reverse")]),
+    }),
+    ss.object({
+        type: ss.literal("function"),
+        function_key: ss.string(),
+    }),
+]);
+
+/** 
+    "ExtraSortFunctions" are NOT js functions.
+    They are DESCRIPTIONS of sort functions implemented by the backend.
+    The only thing the front-end does with them is display some kind of sort-picker.
+ */
+const ExtraSortFunctionStruct = ss.object({
+    /** will be submitted to back-end */
+    key: ss.string(),
+    /** what to display in sort-picker */
+    display: ss.string(),
+    /** help text, in case `display` is not self-explanatory */
+    help_text: ss.defaulted(ss.string(), ""),
+});
+export type ExtraSortFunction = ss.Infer<typeof ExtraSortFunctionStruct>;
+
+const TableOptionsStruct = ss.object({
+    columns: ss.array(ColumnStruct),
+    allow_selection: ss.defaulted(ss.boolean(), false),
+    api_url: ss.defaulted(ss.string(), "."),
+
+    // If non-empty, MUST reference a <form> element on the page
+    filter_form_id: ss.defaulted(ss.string(), ""),
+
+    // Must be unique across all data tables on a given page (used in constructing CSS classes and Storage keys)
+    // Must be unique across all tables submitting to same api_url (used in constructing keys for backend communication)
+    // Must contain only alphanumerics, underscores, and hyphens
+    key_prefix: ss.defaulted(css_class_component(), "table-manager"),
+
+    // if the table is associated with a filter form, it will refresh on submit events
+    // additionally, if this is set, the table will refresh on any change event on the form
+    refresh_on_change: ss.defaulted(ss.boolean(), true),
+
+    page_size: ss.integer(),
+    page_limit: ss.integer(),
+    table_limit: ss.integer(),
+
+    // If last page of data has fewer rows than page_size and this is set, we'll add empty rows
+    // keeps layout/height more consistent, regardless of data
+    fill_last_page: ss.defaulted(ss.boolean(), true),
+
+    // Initial sort key to pass to backend, if user has not chosen something else
+    // Empty string means "use first enabled sortable column"
+    default_sort_key: ss.defaulted(ss.string(), ""),
+
+    /** Where table layout preferences (columns, column widths) are stored */
+    layout_storage: ss.defaulted(OptionalStorageStruct, "localStorage"),
+
+    /** where page number is stored */
+    navigation_storage: ss.defaulted(OptionalStorageStruct, "sessionStorage"),
+
+    /** where selection is stored */
+    selection_storage: ss.defaulted(OptionalStorageStruct, "sessionStorage"),
+
+    /** where sort order is stored */
+    sort_storage: ss.defaulted(OptionalStorageStruct, "localStorage"),
+
+    /** when non-empty, will cause a "sort widget" to be displayed in the paginator */
+    extra_sort_functions: ss.defaulted(ss.array(ExtraSortFunctionStruct), []),
+
+    default_sort: ss.defaulted(
+        ss.union([SortStateStruct, ss.literal(null)]),
+        null,
+    ),
+});
+
+export type TableOptions = ss.Infer<typeof TableOptionsStruct>;
+
+export function read_options_from_json_string(json: string): TableOptions {
+    return ss.create(JSON.parse(json), TableOptionsStruct);
+}

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"fileNames":["../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es6.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es5.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.dom.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.dom.iterable.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.webworker.importscripts.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.scripthost.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.core.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.decorators.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.decorators.legacy.d.ts","../node_modules/@types/mithril/index.d.ts","../node_modules/@qnc/drag_sorter/dist/npm/drag_sorter.d.ts","../src/qnc_data_tables_inline_css.d.ts","../src/qnc_data_tables.ts"],"fileIdsList":[[19,20,21]],"fileInfos":[{"version":"df039a67536fe2acc3affdcbfb645892f842db36fe599e8e652e2f0c640a90d1","impliedFormat":1},{"version":"69684132aeb9b5642cbcd9e22dff7818ff0ee1aa831728af0ecf97d3364d5546","affectsGlobalScope":true,"impliedFormat":1},{"version":"45b7ab580deca34ae9729e97c13cfd999df04416a79116c3bfb483804f85ded4","impliedFormat":1},{"version":"092c2bfe125ce69dbb1223c85d68d4d2397d7d8411867b5cc03cec902c233763","affectsGlobalScope":true,"impliedFormat":1},{"version":"07f073f19d67f74d732b1adea08e1dc66b1b58d77cb5b43931dee3d798a2fd53","affectsGlobalScope":true,"impliedFormat":1},{"version":"80e18897e5884b6723488d4f5652167e7bb5024f946743134ecc4aa4ee731f89","affectsGlobalScope":true,"impliedFormat":1},{"version":"cd034f499c6cdca722b60c04b5b1b78e058487a7085a8e0d6fb50809947ee573","affectsGlobalScope":true,"impliedFormat":1},{"version":"c57796738e7f83dbc4b8e65132f11a377649c00dd3eee333f672b8f0a6bea671","affectsGlobalScope":true,"impliedFormat":1},{"version":"dc2df20b1bcdc8c2d34af4926e2c3ab15ffe1160a63e58b7e09833f616efff44","affectsGlobalScope":true,"impliedFormat":1},{"version":"515d0b7b9bea2e31ea4ec968e9edd2c39d3eebf4a2d5cbd04e88639819ae3b71","affectsGlobalScope":true,"impliedFormat":1},{"version":"0559b1f683ac7505ae451f9a96ce4c3c92bdc71411651ca6ddb0e88baaaad6a3","affectsGlobalScope":true,"impliedFormat":1},{"version":"0dc1e7ceda9b8b9b455c3a2d67b0412feab00bd2f66656cd8850e8831b08b537","affectsGlobalScope":true,"impliedFormat":1},{"version":"ce691fb9e5c64efb9547083e4a34091bcbe5bdb41027e310ebba8f7d96a98671","affectsGlobalScope":true,"impliedFormat":1},{"version":"8d697a2a929a5fcb38b7a65594020fcef05ec1630804a33748829c5ff53640d0","affectsGlobalScope":true,"impliedFormat":1},{"version":"4ff2a353abf8a80ee399af572debb8faab2d33ad38c4b4474cff7f26e7653b8d","affectsGlobalScope":true,"impliedFormat":1},{"version":"936e80ad36a2ee83fc3caf008e7c4c5afe45b3cf3d5c24408f039c1d47bdc1df","affectsGlobalScope":true,"impliedFormat":1},{"version":"8e7f8264d0fb4c5339605a15daadb037bf238c10b654bb3eee14208f860a32ea","affectsGlobalScope":true,"impliedFormat":1},{"version":"782dec38049b92d4e85c1585fbea5474a219c6984a35b004963b00beb1aab538","affectsGlobalScope":true,"impliedFormat":1},{"version":"7c4f7cb8a662bd8b8eec4a712d2bfc40cb2efc3248292dcd2a7fa80d5935c85e","affectsGlobalScope":true,"impliedFormat":1},{"version":"ebdfbfedbd3b85bb714d114c948f30e6ff0991a6162d3b01cd18a2d9c8aa0bb7","impliedFormat":99},{"version":"6112bc1341c6e1a3f072a934b0de0e26982a18cac9b97944f4cb86158ee58f00","impliedFormat":99},{"version":"f50a035fc22774601148adadc2658fb6eadfe75e61a9f47a1de9ad5484297636","signature":"900aedb381fbbe59ae8934a6dddc2da285002ae61980f11b71ec73dd5690f488","impliedFormat":99}],"root":[21,22],"options":{"declaration":true,"esModuleInterop":true,"module":199,"noImplicitAny":true,"noUncheckedIndexedAccess":true,"outDir":"./","strict":true,"target":2},"referencedMap":[[22,1]],"version":"5.8.3"}
+{"fileNames":["../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es6.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es5.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.dom.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.dom.iterable.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.webworker.importscripts.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.scripthost.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.core.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.decorators.d.ts","../../../../.nvm/versions/node/v22.16.0/lib/node_modules/typescript/lib/lib.decorators.legacy.d.ts","../node_modules/@qnc/type_utils/build/index.d.ts","../src/bound_stored_value.ts","../node_modules/superstruct/dist/error.d.ts","../node_modules/superstruct/dist/utils.d.ts","../node_modules/superstruct/dist/struct.d.ts","../node_modules/superstruct/dist/structs/coercions.d.ts","../node_modules/superstruct/dist/structs/refinements.d.ts","../node_modules/superstruct/dist/structs/types.d.ts","../node_modules/superstruct/dist/structs/utilities.d.ts","../node_modules/superstruct/dist/index.d.ts","../src/table_options.ts","../src/column_manager.ts","../src/column_resizing.ts","../src/watched_mutable_value.ts","../src/state_types.ts","../src/column_sorting.ts","../src/conditionally_wrapped_element.ts","../src/event_names.ts","../src/state_machine.ts","../node_modules/@types/mithril/index.d.ts","../src/renderer.ts","../node_modules/@qnc/drag_sorter/dist/npm/drag_sorter.d.ts","../src/mithril_view.ts","../src/create_mithril_app.ts","../intermediate/qnc_data_tables_inline_css.d.ts","../src/create_style.ts","../src/table_manager.ts","../src/custom_element.ts","../src/selection_fieldset_controller.ts","../src/index.ts","../src/optional_storage.ts","../src/overflow_class_manager.ts"],"fileIdsList":[[21,23,24,25,26,27],[21,22],[23],[22,23],[21,23],[19],[19,28,29],[19,33],[37,38,39,41],[43],[29,33,35,37,38,39,42,45],[29,39,44,46,47],[29,30,31,32,33,38,39,40],[38],[45,46],[19,20,29,30,32,33,34,36],[29,30,32],[36,37],[19,28]],"fileInfos":[{"version":"df039a67536fe2acc3affdcbfb645892f842db36fe599e8e652e2f0c640a90d1","impliedFormat":1},{"version":"69684132aeb9b5642cbcd9e22dff7818ff0ee1aa831728af0ecf97d3364d5546","affectsGlobalScope":true,"impliedFormat":1},{"version":"45b7ab580deca34ae9729e97c13cfd999df04416a79116c3bfb483804f85ded4","impliedFormat":1},{"version":"092c2bfe125ce69dbb1223c85d68d4d2397d7d8411867b5cc03cec902c233763","affectsGlobalScope":true,"impliedFormat":1},{"version":"07f073f19d67f74d732b1adea08e1dc66b1b58d77cb5b43931dee3d798a2fd53","affectsGlobalScope":true,"impliedFormat":1},{"version":"80e18897e5884b6723488d4f5652167e7bb5024f946743134ecc4aa4ee731f89","affectsGlobalScope":true,"impliedFormat":1},{"version":"cd034f499c6cdca722b60c04b5b1b78e058487a7085a8e0d6fb50809947ee573","affectsGlobalScope":true,"impliedFormat":1},{"version":"c57796738e7f83dbc4b8e65132f11a377649c00dd3eee333f672b8f0a6bea671","affectsGlobalScope":true,"impliedFormat":1},{"version":"dc2df20b1bcdc8c2d34af4926e2c3ab15ffe1160a63e58b7e09833f616efff44","affectsGlobalScope":true,"impliedFormat":1},{"version":"515d0b7b9bea2e31ea4ec968e9edd2c39d3eebf4a2d5cbd04e88639819ae3b71","affectsGlobalScope":true,"impliedFormat":1},{"version":"0559b1f683ac7505ae451f9a96ce4c3c92bdc71411651ca6ddb0e88baaaad6a3","affectsGlobalScope":true,"impliedFormat":1},{"version":"0dc1e7ceda9b8b9b455c3a2d67b0412feab00bd2f66656cd8850e8831b08b537","affectsGlobalScope":true,"impliedFormat":1},{"version":"ce691fb9e5c64efb9547083e4a34091bcbe5bdb41027e310ebba8f7d96a98671","affectsGlobalScope":true,"impliedFormat":1},{"version":"8d697a2a929a5fcb38b7a65594020fcef05ec1630804a33748829c5ff53640d0","affectsGlobalScope":true,"impliedFormat":1},{"version":"4ff2a353abf8a80ee399af572debb8faab2d33ad38c4b4474cff7f26e7653b8d","affectsGlobalScope":true,"impliedFormat":1},{"version":"936e80ad36a2ee83fc3caf008e7c4c5afe45b3cf3d5c24408f039c1d47bdc1df","affectsGlobalScope":true,"impliedFormat":1},{"version":"8e7f8264d0fb4c5339605a15daadb037bf238c10b654bb3eee14208f860a32ea","affectsGlobalScope":true,"impliedFormat":1},{"version":"782dec38049b92d4e85c1585fbea5474a219c6984a35b004963b00beb1aab538","affectsGlobalScope":true,"impliedFormat":1},{"version":"c3ac004344cd885a3e9900c9c791da896c6c19c2fea8812a3196694b18624058","impliedFormat":99},{"version":"b9655fec9e804d1a5c0c982f078c2727c1df6ade35c415f7134d04257d39b792","signature":"f50456435236fdfb4bdb108b048c001ad3f963ec72593f90f6a50c62dfa3d953","impliedFormat":99},{"version":"56e933722bc0b995aa96a7d023497871ce07d1500d9dae9e95875b3208b23169","impliedFormat":99},{"version":"ce84cd04b7ff2a0935c34d426d049a4738dc1d32300f713e8f674b2fea83520b","impliedFormat":99},{"version":"1431e40edac4e9251b18760a8b7e294a3be538d15ec1bac6e90ea84efbd75434","impliedFormat":99},{"version":"6cc836c7185e9763e11d373e166b1f6f523b3b2de800af03cc8db68583ce6c03","impliedFormat":99},{"version":"ce4399c8e23cd32b5e9c245b57bf86bcf07773ff0fce06435520afd9e36ce511","impliedFormat":99},{"version":"b11eab7b532862de69b97b30ff6f4ea177573f017dc9177fe463e20fa8e8f3af","impliedFormat":99},{"version":"e9340584b4b5ee347c65b1f6db1b83c6e77a68db39b078780abdc076711eb815","impliedFormat":99},{"version":"70d9e74d5210f57d00925ce312dd29c7ae3ef49b8d0a7f896fb28ed1578b17c3","impliedFormat":99},{"version":"f260b75cccb7aeb744c918383f0802439edd489456eaf19cb881596edd6a28df","signature":"3a1376592753ac25aa0e5be921f708c10c92dda0038d4c532898dcdde80669ea","impliedFormat":99},{"version":"fb269872ac1ad5670145cf17c5dc6e6a260a45851bad0a25626a0b99ee343178","signature":"c39f3f0217ba6ffb4f99d5bba8035d0a7053008349fbc40ddee4c7cf0aa4a305","impliedFormat":99},{"version":"3f282694019489510ad94603a83fef03d0c4f3eb87b0e9acea0bd10bf0e5fbad","signature":"08430a86a223b1c96c83759fce45b89c3f4eb3fad5789ac3b16abd84f676d801","impliedFormat":99},{"version":"0fa88d7f497c6be699c7f0c1a5df29d3c831b6224d142cb13c706bece49a7964","signature":"49c05a47e0d95561844f886a410b4f9b37e938b208caa410a4a953ef94231be3","impliedFormat":99},{"version":"cc97bcbb9491923679fcaddd7ea4693fb51240205d36687ee03e6d4349065383","signature":"317d9fe91e003b8bd007841a22a18ccd3638ff472ee11c62fa658a23b6e69949","impliedFormat":99},{"version":"37b3a75065dd4328ab07a74e437c9bf9db9596e8a4b95d5b97118d699eca8a36","signature":"19da0d94fde1c3d8b2d184b20c1dcc27773c9e36f8448733f958f57f7bd0ccef","impliedFormat":99},{"version":"9b73eafa6c6ce2e98429a7a875c1efe2f53f10e2980671b8f4759d97cd112992","signature":"1ef769db3b1a03d9d69e9b6c7ade7a713b44d8e7d7beaf43a0b0f376a3433d04","impliedFormat":99},{"version":"cdb540d13c6ff674fb817cd1731f1cd5e841b213486f3f039d81993be9bb7c83","signature":"a874d76d20f351b70787a2ce6bcfa50aa8e09a18a0f566fa7e50a116b60e3927","impliedFormat":99},{"version":"d738ec3d508305b8c751c3df13651c65b9e3bc7167b9a02eb6788e96586bd84e","signature":"ab39ff0da30c9b6089a0fb9c188b4297ce8d91694d37d8f578f09150f0fcbf1c","impliedFormat":99},{"version":"7c4f7cb8a662bd8b8eec4a712d2bfc40cb2efc3248292dcd2a7fa80d5935c85e","affectsGlobalScope":true,"impliedFormat":1},{"version":"c958694cb815759fdbb55f2c17c57014907cbe871b488dfe4afb95bbd1377f07","signature":"54198656fece9670c3f97e3e6b19d4835c8a8e1aac1c5d654dd7d08167d223ce","impliedFormat":99},{"version":"ebdfbfedbd3b85bb714d114c948f30e6ff0991a6162d3b01cd18a2d9c8aa0bb7","impliedFormat":99},{"version":"9d6ee454201e564f5719ef4c93ee2c0848e29e9d43b3b8fe3612b6f5e97b31b5","signature":"eec30d355fadbcd5517512b0eb4d6f254a0740c68f00cf5e8d92cf2c7395b2a3","impliedFormat":99},{"version":"1fe29a6585ba8e801b8039bc1b38a2906ae6c0992d228d10052ee2dce0734572","signature":"01d66077fab5a605168eda3d63521b9c18273ac6f24c338bcb8cadb5bea0429a","impliedFormat":99},{"version":"6112bc1341c6e1a3f072a934b0de0e26982a18cac9b97944f4cb86158ee58f00","impliedFormat":99},{"version":"c7fc1faa87da67e586529a23efa3619028f3410844031d37602d30e7ec455390","signature":"a32c781b7e8666951242aa77a3594db0bcc809435a3aa4fc753043c1d3d05359","impliedFormat":99},{"version":"eb398eee10130c7ae74100afb8e6767cc67511c5060bfdff9ba82d57717493a7","signature":"937e6463557ae49ed5ff5bcde2741a9a88e3bc4a60e00a3671277aa9200e8607","impliedFormat":99},{"version":"c43e6d54a9a425a1256e5756611c5f4c7c0180dda198712de6df78c8fb80764f","signature":"7b2fe70181cc14d801e496ebe57931d9a162e928d36d5e92d171ac9b0b1d5102","impliedFormat":99},{"version":"6f099c7a3ac41d6f7b048dc12fa8b0ca987d471cb18b5fabcce10304e11e42ed","signature":"98f165bc8a33ea7a96bcc6521bef9fa1e0f6cc6ad17eb22065817338cdd0384e","impliedFormat":99},{"version":"99ff6f4f0316abce4aba84f8ad1fa8fcda70bb634611167fd137e20f09be687a","impliedFormat":99},{"version":"639d09070bc5a1a6712e0dc0c9ca0c85713474b95142b6f04f20af07d1cb5e41","signature":"eb9159adc2c9f22f2ede632b4bdd2625b76b28a8907700c7701c4f28b5834530","impliedFormat":99},{"version":"e11c3816af66cef18033102beb8116f978648b99abbbd5a5af46cae507ed642d","signature":"0e1b5dda8ed10831fc1a25a7b6cee85cc6a3810d2afafda84712d485c4d60594","impliedFormat":99}],"root":[20,[29,37],39,41,42,[44,50]],"options":{"declaration":true,"esModuleInterop":true,"module":199,"noImplicitAny":true,"noUncheckedIndexedAccess":true,"outDir":"./","strict":true,"target":2},"referencedMap":[[28,1],[23,2],[24,3],[25,3],[26,4],[27,4],[22,5],[20,6],[30,7],[34,8],[42,9],[44,10],[46,11],[48,12],[41,13],[39,14],[47,15],[37,16],[33,17],[45,18],[29,19]],"version":"5.8.3"}

package/dist/watched_mutable_value.d.ts

@@ -0,0 +1,15 @@
+/**
+    Intended to hold values which must be determined by the view layer (ie. which depend on rendered layout)
+    and which affect other aspects of the UI.
+
+    Example: the UI renders an element, then checks if that element has overflow, then wants to toggle a class on that element in response to the check.
+
+    Your state machine / "data store" should own/create the WatchedMutableValue. It can pass it directly to the view layer, which is free to update it.
+*/
+export declare class WatchedMutableValue<T> {
+    private value;
+    private onchange;
+    constructor(value: T, onchange: () => void);
+    get(): T;
+    set(value: T): void;
+}

package/dist/watched_mutable_value.js

@@ -0,0 +1,23 @@
+/**
+    Intended to hold values which must be determined by the view layer (ie. which depend on rendered layout)
+    and which affect other aspects of the UI.
+
+    Example: the UI renders an element, then checks if that element has overflow, then wants to toggle a class on that element in response to the check.
+
+    Your state machine / "data store" should own/create the WatchedMutableValue. It can pass it directly to the view layer, which is free to update it.
+*/
+export class WatchedMutableValue {
+    constructor(value, onchange) {
+        this.value = value;
+        this.onchange = onchange;
+    }
+    get() {
+        return this.value;
+    }
+    set(value) {
+        const changed = this.value != value;
+        this.value = value;
+        if (changed)
+            this.onchange();
+    }
+}

package/dist/watched_mutable_value.ts

@@ -0,0 +1,23 @@
+/**
+    Intended to hold values which must be determined by the view layer (ie. which depend on rendered layout)
+    and which affect other aspects of the UI.
+
+    Example: the UI renders an element, then checks if that element has overflow, then wants to toggle a class on that element in response to the check.
+
+    Your state machine / "data store" should own/create the WatchedMutableValue. It can pass it directly to the view layer, which is free to update it.
+*/
+export class WatchedMutableValue<T> {
+    constructor(
+        private value: T,
+        private onchange: () => void,
+    ) {}
+
+    get() {
+        return this.value;
+    }
+    set(value: T) {
+        const changed = this.value != value;
+        this.value = value;
+        if (changed) this.onchange();
+    }
+}

package/package.json

@@ -1,13 +1,16 @@
 {
   "private": false,
   "name": "@qnc/qnc_data_tables",
-  "files": ["dist/*"],
-  "version": "1.0.4",
+  "files": [
+    "dist/*",
+    "README.md"
+  ],
+  "version": "1.0.6-a",
   "description": "Work-in-progress",
-  "main": "dist/qnc_data_tables.js",
+  "main": "dist/index.js",
   "scripts": {
     "watch_css": "when-changed src/qnc_data_tables.css -c \"node inline_css.js\"",
-    "watch_typescript": "tsc -w",
+    "watch_typescript": "tsc -w --sourceMap",
     "start": "node inline_css.js && npm-run-all -pr watch_css watch_typescript"
   },
   "type": "module",
@@ -19,8 +22,12 @@
     "npm-run-all": "^4.1.5"
   },
   "peerDependencies": {
-    "@types/mithril": "^2.2.7",
     "@qnc/drag_sorter": "^0.1.0",
+    "@qnc/type_utils": "^1.2.0",
+    "@types/mithril": "^2.2.7",
     "mithril": "^2.3.0"
+  },
+  "dependencies": {
+    "superstruct": "^2.0.2"
   }
 }

package/dist/qnc_data_tables.d.ts

@@ -1,57 +0,0 @@
-import m from "mithril";
-/**
- * Create a <style> element that users should inject into their document somewhere.
- */
-export declare function make_style(): HTMLStyleElement;
-export declare function require_array(value: unknown): unknown[];
-export declare function require_array_of<T>(value: unknown, element_validator: (value: unknown) => T): T[];
-export type HeaderRendererArgs = {
-    text: string;
-    help_text: string | null | m.Children;
-    sortable: boolean;
-    sorted: boolean;
-    sorted_reverse: boolean;
-    sort: () => void;
-    sort_reverse: () => void;
-};
-export type FormRendererArgs = {
-    result_count_loading: boolean;
-    result_count: null | number;
-    /** Indicates result set is truncated because it's too big */
-    results_limited: boolean;
-    /** Will be set when results_limited is set. Indicates max number of rows we allow accessing. */
-    results_limited_to: null | number;
-    table_data_loading: boolean;
-    table: m.Children;
-    current_page: number;
-    total_pages: number;
-    set_page: (page_number: number) => void;
-    page_size: number;
-    set_page_size: (row_count: number) => void;
-    editable_columns_list: m.Children;
-    /** how many rows are selected */
-    selected_row_count: number;
-    /** true iff all results (on all pages) are selected */
-    all_results_selected: boolean;
-    /** true iff all results on the current page are selected */
-    entire_page_selected: boolean;
-    selection_buttons: m.Children[];
-    /** select all results on the current page */
-    select_page: () => void;
-    /** deselect all results on the current page */
-    clear_page: () => void;
-    /** select all of the currently included results on all pages */
-    select_table: () => void;
-    /** deselect all of the currently included results on all pages */
-    clear_table: () => void;
-    /** clear all rows from the selection, whether they are matched by current filters or not */
-    clear_selection: () => void;
-};
-type Renderer = {
-    help_text: (text: string) => m.Children;
-    header: (args: HeaderRendererArgs) => m.Children;
-    form_content: (args: FormRendererArgs) => m.Children;
-};
-export declare function register_renderer(name: string, renderer: Partial<Renderer>): void;
-export declare function define(tag_name: string): void;
-export {};