@codual/react-native-ui 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (141) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +2 -0
  3. package/README.md +18 -2
  4. package/dist/announce.d.ts +2 -0
  5. package/dist/announce.js +8 -0
  6. package/dist/charts/data.d.ts +32 -0
  7. package/dist/charts/data.js +13 -0
  8. package/dist/charts/labels.d.ts +54 -0
  9. package/dist/charts/labels.js +91 -0
  10. package/dist/charts/machine.d.ts +62 -0
  11. package/dist/charts/machine.js +144 -0
  12. package/dist/charts/points.d.ts +23 -0
  13. package/dist/charts/points.js +46 -0
  14. package/dist/charts/summary.d.ts +29 -0
  15. package/dist/charts/summary.js +45 -0
  16. package/dist/charts/use-chart-interaction.d.ts +62 -0
  17. package/dist/charts/use-chart-interaction.js +79 -0
  18. package/dist/forms/async-checks.d.ts +34 -0
  19. package/dist/forms/async-checks.js +77 -0
  20. package/dist/forms/field-errors.d.ts +8 -0
  21. package/dist/forms/field-errors.js +16 -0
  22. package/dist/forms/form-types.d.ts +43 -0
  23. package/dist/forms/form-types.js +2 -0
  24. package/dist/forms/machine.d.ts +63 -0
  25. package/dist/forms/machine.js +251 -0
  26. package/dist/forms/numbers.d.ts +5 -0
  27. package/dist/forms/numbers.js +83 -0
  28. package/dist/forms/rules.d.ts +47 -0
  29. package/dist/forms/rules.js +72 -0
  30. package/dist/forms/server-errors.d.ts +17 -0
  31. package/dist/forms/server-errors.js +22 -0
  32. package/dist/forms/use-form.d.ts +49 -0
  33. package/dist/forms/use-form.js +61 -0
  34. package/dist/index.d.ts +50 -0
  35. package/dist/index.js +94 -0
  36. package/dist/lists/PagedList.d.ts +47 -0
  37. package/dist/lists/PagedList.js +81 -0
  38. package/dist/lists/controller.d.ts +23 -0
  39. package/dist/lists/controller.js +20 -0
  40. package/dist/lists/inverted-list.d.ts +23 -0
  41. package/dist/lists/inverted-list.js +60 -0
  42. package/dist/lists/machine.d.ts +81 -0
  43. package/dist/lists/machine.js +252 -0
  44. package/dist/lists/newest-end.d.ts +30 -0
  45. package/dist/lists/newest-end.js +58 -0
  46. package/dist/lists/paged-content.d.ts +46 -0
  47. package/dist/lists/paged-content.js +65 -0
  48. package/dist/lists/paged-list-types.d.ts +56 -0
  49. package/dist/lists/paged-list-types.js +2 -0
  50. package/dist/lists/system-footer.d.ts +28 -0
  51. package/dist/lists/system-footer.js +50 -0
  52. package/dist/lists/use-paged-list.d.ts +25 -0
  53. package/dist/lists/use-paged-list.js +34 -0
  54. package/dist/permissions/access.d.ts +30 -0
  55. package/dist/permissions/access.js +2 -0
  56. package/dist/permissions/android-permission.d.ts +52 -0
  57. package/dist/permissions/android-permission.js +143 -0
  58. package/dist/permissions/permission.d.ts +69 -0
  59. package/dist/permissions/permission.js +201 -0
  60. package/dist/permissions/setup.d.ts +25 -0
  61. package/dist/permissions/setup.js +41 -0
  62. package/dist/permissions/status.d.ts +29 -0
  63. package/dist/permissions/status.js +18 -0
  64. package/dist/permissions/use-permission.d.ts +23 -0
  65. package/dist/permissions/use-permission.js +29 -0
  66. package/dist/purchases/Paywall.d.ts +27 -0
  67. package/dist/purchases/Paywall.js +28 -0
  68. package/dist/purchases/paywall-content.d.ts +20 -0
  69. package/dist/purchases/paywall-content.js +34 -0
  70. package/dist/purchases/purchases.d.ts +92 -0
  71. package/dist/purchases/purchases.js +236 -0
  72. package/dist/purchases/status.d.ts +62 -0
  73. package/dist/purchases/status.js +25 -0
  74. package/dist/purchases/store.d.ts +71 -0
  75. package/dist/purchases/store.js +2 -0
  76. package/dist/purchases/system-views.d.ts +49 -0
  77. package/dist/purchases/system-views.js +91 -0
  78. package/dist/purchases/use-purchases.d.ts +3 -0
  79. package/dist/purchases/use-purchases.js +8 -0
  80. package/dist/react-native-iap/iap-purchases.d.ts +24 -0
  81. package/dist/react-native-iap/iap-purchases.js +90 -0
  82. package/dist/react-native-iap/iap-store.d.ts +56 -0
  83. package/dist/react-native-iap/iap-store.js +249 -0
  84. package/dist/react-native-iap/iap-types.d.ts +12 -0
  85. package/dist/react-native-iap/iap-types.js +11 -0
  86. package/dist/react-native-iap/index.d.ts +31 -0
  87. package/dist/react-native-iap/index.js +24 -0
  88. package/dist/react-native-permissions/index.d.ts +24 -0
  89. package/dist/react-native-permissions/index.js +88 -0
  90. package/dist/screen-states/ScreenStates.d.ts +38 -0
  91. package/dist/screen-states/ScreenStates.js +69 -0
  92. package/dist/screen-states/errors.d.ts +9 -0
  93. package/dist/screen-states/errors.js +24 -0
  94. package/dist/screen-states/machine.d.ts +97 -0
  95. package/dist/screen-states/machine.js +172 -0
  96. package/dist/screen-states/system-views.d.ts +40 -0
  97. package/dist/screen-states/system-views.js +66 -0
  98. package/dist/screen-states/use-screen-states.d.ts +23 -0
  99. package/dist/screen-states/use-screen-states.js +41 -0
  100. package/dist/search/SearchResults.d.ts +22 -0
  101. package/dist/search/SearchResults.js +25 -0
  102. package/dist/search/announcements.d.ts +17 -0
  103. package/dist/search/announcements.js +31 -0
  104. package/dist/search/labels.d.ts +15 -0
  105. package/dist/search/labels.js +14 -0
  106. package/dist/search/machine.d.ts +65 -0
  107. package/dist/search/machine.js +241 -0
  108. package/dist/search/recent-search-sync.d.ts +32 -0
  109. package/dist/search/recent-search-sync.js +87 -0
  110. package/dist/search/recent-searches.d.ts +22 -0
  111. package/dist/search/recent-searches.js +40 -0
  112. package/dist/search/system-views.d.ts +11 -0
  113. package/dist/search/system-views.js +16 -0
  114. package/dist/search/types.d.ts +51 -0
  115. package/dist/search/types.js +2 -0
  116. package/dist/search/use-search.d.ts +73 -0
  117. package/dist/search/use-search.js +123 -0
  118. package/dist/selection/config.d.ts +34 -0
  119. package/dist/selection/config.js +13 -0
  120. package/dist/selection/labels.d.ts +19 -0
  121. package/dist/selection/labels.js +23 -0
  122. package/dist/selection/machine.d.ts +80 -0
  123. package/dist/selection/machine.js +274 -0
  124. package/dist/selection/snapshot.d.ts +54 -0
  125. package/dist/selection/snapshot.js +45 -0
  126. package/dist/selection/state.d.ts +25 -0
  127. package/dist/selection/state.js +24 -0
  128. package/dist/selection/system-views.d.ts +11 -0
  129. package/dist/selection/system-views.js +22 -0
  130. package/dist/selection/use-selection.d.ts +73 -0
  131. package/dist/selection/use-selection.js +100 -0
  132. package/dist/sheets/machine.d.ts +101 -0
  133. package/dist/sheets/machine.js +213 -0
  134. package/dist/sheets/use-sheet.d.ts +78 -0
  135. package/dist/sheets/use-sheet.js +103 -0
  136. package/dist/victory-native/index.d.ts +37 -0
  137. package/dist/victory-native/index.js +41 -0
  138. package/package.json +94 -4
  139. package/react-native-iap/package.json +4 -0
  140. package/react-native-permissions/package.json +4 -0
  141. package/victory-native/package.json +4 -0
@@ -0,0 +1,50 @@
1
+ /** The Codual UI release this build comes from. */
2
+ export declare const version = "0.1.0";
3
+ export type { ChartData, ChartPoint, ChartQuery, ChartSeries, PlottedData } from "./charts/data";
4
+ export { type ChartChangeText, type ChartLabels, type ChartXKind, defaultChartLabels, } from "./charts/labels";
5
+ export type { ChartInteractionSnapshot, LoadChart } from "./charts/machine";
6
+ export { type ChartSelectedPoint, type ChartSelection, selectionNearest } from "./charts/points";
7
+ export type { ChartComparison, ChartComparisonMeasure, ChartSeriesSummary } from "./charts/summary";
8
+ export { type ChartAccessibilityProps, type ChartInteractionController, type ChartInteractionOptions, useChartInteraction, } from "./charts/use-chart-interaction";
9
+ export { FormFieldErrors } from "./forms/field-errors";
10
+ export type { Focusable, FormFieldOptions, FormFields, FormSnapshot, SubmitAction, SubmitError, } from "./forms/form-types";
11
+ export { parseNumber } from "./forms/numbers";
12
+ export { type AsyncFormRule, type AsyncFormRuleOptions, asyncRule, email, type FormRule, type FormValues, matches, maxLength, minLength, type NumberRuleOptions, number, pattern, required, rule, } from "./forms/rules";
13
+ export { type FormController, type FormFieldHelperOptions, type FormOptions, type FormTextInputProps, useForm, } from "./forms/use-form";
14
+ export type { PagedListController } from "./lists/controller";
15
+ export type { LoadPage, PagedListFooter, PagedListSnapshot } from "./lists/machine";
16
+ export { PagedList, type PagedListProps, type PagedListRenderItemInfo, PagedListView, type PagedListViewProps, } from "./lists/PagedList";
17
+ export type { Page } from "./lists/paged-content";
18
+ export { defaultPagedListLabels, type PagedListLabels, SystemPagedListFooter } from "./lists/system-footer";
19
+ export { type PagedListOptions, usePagedList } from "./lists/use-paged-list";
20
+ export type { PermissionAccess, PermissionMemory } from "./permissions/access";
21
+ export { type AndroidPermissionName, type AndroidPermissionOptions, androidPermission, type CustomAndroidPermission, } from "./permissions/android-permission";
22
+ export { createPermission, type Permission, type PermissionOptions, type PermissionSnapshot, } from "./permissions/permission";
23
+ export { type BooleanStorage, configurePermissions, type PermissionsSetup, permissionMemory, } from "./permissions/setup";
24
+ export { isUsable, type PermissionPhase, type PermissionStatus } from "./permissions/status";
25
+ export { type PermissionController, usePermission } from "./permissions/use-permission";
26
+ export { Paywall, type PaywallProps } from "./purchases/Paywall";
27
+ export type { PaywallContent } from "./purchases/paywall-content";
28
+ export { createPurchases, type Purchases, type PurchasesOptions, type PurchasesSnapshot, } from "./purchases/purchases";
29
+ export type { BuyButtonState, PurchaseMessage, PurchaseStatus } from "./purchases/status";
30
+ export type { Entitlement, ProductKind, PurchaseStore, StoreProduct, StorePurchaseResult, StoreSyncResult, StoreTransaction, StoreUpdate, } from "./purchases/store";
31
+ export { defaultPaywallLabels, type PaywallLabels, SystemBuyButton, SystemProductRow, SystemPurchaseMessageAlert, SystemRestoreButton, } from "./purchases/system-views";
32
+ export { usePurchases } from "./purchases/use-purchases";
33
+ export { isOfflineError } from "./screen-states/errors";
34
+ export type { Load, RefreshError, ScreenState, ScreenStatesSnapshot } from "./screen-states/machine";
35
+ export { ScreenStates, type ScreenStatesProps } from "./screen-states/ScreenStates";
36
+ export { defaultScreenStatesLabels, type ScreenStatesLabels, SystemEmptyView, SystemFailedView, SystemLoadingView, SystemOfflineView, SystemRefreshErrorAlert, } from "./screen-states/system-views";
37
+ export { type ScreenStatesController, type ScreenStatesOptions, useScreenStates, } from "./screen-states/use-screen-states";
38
+ export { defaultSearchLabels, type SearchLabels } from "./search/labels";
39
+ export { createInMemoryRecentSearches, type RecentSearches, type RecentSearchStore, } from "./search/recent-searches";
40
+ export { SearchResults, type SearchResultsProps } from "./search/SearchResults";
41
+ export { SystemNoResultsView, SystemRecentSearches } from "./search/system-views";
42
+ export type { QueryResults, SearchFunction, SearchRequest, SearchSnapshot } from "./search/types";
43
+ export { type LocalSearchOptions, type RemoteSearchOptions, type SearchController, type SearchInputProps, type SearchListProps, type SearchOptions, useSearch, } from "./search/use-search";
44
+ export type { SelectionAction, SelectionActionContext, SelectionActivation, SelectionKind, } from "./selection/config";
45
+ export { defaultSelectionLabels, type SelectionLabels } from "./selection/labels";
46
+ export type { SelectionActionError, SelectionSnapshot } from "./selection/snapshot";
47
+ export { SelectAllButton, SelectionModeButton } from "./selection/system-views";
48
+ export { type SelectionController, type SelectionOptions, type SelectionRowProps, useSelection, } from "./selection/use-selection";
49
+ export type { SaveError, SaveSheet, SheetResult, SheetSnapshot } from "./sheets/machine";
50
+ export { defaultSheetLabels, type ModalSheetProps, modalSheet, type PresentOptions, type SheetAdapter, type SheetBinding, type SheetController, type SheetLabels, type SheetOptions, useSheet, } from "./sheets/use-sheet";
package/dist/index.js ADDED
@@ -0,0 +1,94 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.useSearch = exports.SystemRecentSearches = exports.SystemNoResultsView = exports.SearchResults = exports.createInMemoryRecentSearches = exports.defaultSearchLabels = exports.useScreenStates = exports.SystemRefreshErrorAlert = exports.SystemOfflineView = exports.SystemLoadingView = exports.SystemFailedView = exports.SystemEmptyView = exports.defaultScreenStatesLabels = exports.ScreenStates = exports.isOfflineError = exports.usePurchases = exports.SystemRestoreButton = exports.SystemPurchaseMessageAlert = exports.SystemProductRow = exports.SystemBuyButton = exports.defaultPaywallLabels = exports.createPurchases = exports.Paywall = exports.usePermission = exports.isUsable = exports.permissionMemory = exports.configurePermissions = exports.createPermission = exports.androidPermission = exports.usePagedList = exports.SystemPagedListFooter = exports.defaultPagedListLabels = exports.PagedListView = exports.PagedList = exports.useForm = exports.rule = exports.required = exports.pattern = exports.number = exports.minLength = exports.maxLength = exports.matches = exports.email = exports.asyncRule = exports.parseNumber = exports.FormFieldErrors = exports.useChartInteraction = exports.selectionNearest = exports.defaultChartLabels = exports.version = void 0;
4
+ exports.useSheet = exports.modalSheet = exports.defaultSheetLabels = exports.useSelection = exports.SelectionModeButton = exports.SelectAllButton = exports.defaultSelectionLabels = void 0;
5
+ /** The Codual UI release this build comes from. */
6
+ exports.version = "0.1.0";
7
+ var labels_1 = require("./charts/labels");
8
+ Object.defineProperty(exports, "defaultChartLabels", { enumerable: true, get: function () { return labels_1.defaultChartLabels; } });
9
+ var points_1 = require("./charts/points");
10
+ Object.defineProperty(exports, "selectionNearest", { enumerable: true, get: function () { return points_1.selectionNearest; } });
11
+ var use_chart_interaction_1 = require("./charts/use-chart-interaction");
12
+ Object.defineProperty(exports, "useChartInteraction", { enumerable: true, get: function () { return use_chart_interaction_1.useChartInteraction; } });
13
+ var field_errors_1 = require("./forms/field-errors");
14
+ Object.defineProperty(exports, "FormFieldErrors", { enumerable: true, get: function () { return field_errors_1.FormFieldErrors; } });
15
+ var numbers_1 = require("./forms/numbers");
16
+ Object.defineProperty(exports, "parseNumber", { enumerable: true, get: function () { return numbers_1.parseNumber; } });
17
+ var rules_1 = require("./forms/rules");
18
+ Object.defineProperty(exports, "asyncRule", { enumerable: true, get: function () { return rules_1.asyncRule; } });
19
+ Object.defineProperty(exports, "email", { enumerable: true, get: function () { return rules_1.email; } });
20
+ Object.defineProperty(exports, "matches", { enumerable: true, get: function () { return rules_1.matches; } });
21
+ Object.defineProperty(exports, "maxLength", { enumerable: true, get: function () { return rules_1.maxLength; } });
22
+ Object.defineProperty(exports, "minLength", { enumerable: true, get: function () { return rules_1.minLength; } });
23
+ Object.defineProperty(exports, "number", { enumerable: true, get: function () { return rules_1.number; } });
24
+ Object.defineProperty(exports, "pattern", { enumerable: true, get: function () { return rules_1.pattern; } });
25
+ Object.defineProperty(exports, "required", { enumerable: true, get: function () { return rules_1.required; } });
26
+ Object.defineProperty(exports, "rule", { enumerable: true, get: function () { return rules_1.rule; } });
27
+ var use_form_1 = require("./forms/use-form");
28
+ Object.defineProperty(exports, "useForm", { enumerable: true, get: function () { return use_form_1.useForm; } });
29
+ var PagedList_1 = require("./lists/PagedList");
30
+ Object.defineProperty(exports, "PagedList", { enumerable: true, get: function () { return PagedList_1.PagedList; } });
31
+ Object.defineProperty(exports, "PagedListView", { enumerable: true, get: function () { return PagedList_1.PagedListView; } });
32
+ var system_footer_1 = require("./lists/system-footer");
33
+ Object.defineProperty(exports, "defaultPagedListLabels", { enumerable: true, get: function () { return system_footer_1.defaultPagedListLabels; } });
34
+ Object.defineProperty(exports, "SystemPagedListFooter", { enumerable: true, get: function () { return system_footer_1.SystemPagedListFooter; } });
35
+ var use_paged_list_1 = require("./lists/use-paged-list");
36
+ Object.defineProperty(exports, "usePagedList", { enumerable: true, get: function () { return use_paged_list_1.usePagedList; } });
37
+ var android_permission_1 = require("./permissions/android-permission");
38
+ Object.defineProperty(exports, "androidPermission", { enumerable: true, get: function () { return android_permission_1.androidPermission; } });
39
+ var permission_1 = require("./permissions/permission");
40
+ Object.defineProperty(exports, "createPermission", { enumerable: true, get: function () { return permission_1.createPermission; } });
41
+ var setup_1 = require("./permissions/setup");
42
+ Object.defineProperty(exports, "configurePermissions", { enumerable: true, get: function () { return setup_1.configurePermissions; } });
43
+ Object.defineProperty(exports, "permissionMemory", { enumerable: true, get: function () { return setup_1.permissionMemory; } });
44
+ var status_1 = require("./permissions/status");
45
+ Object.defineProperty(exports, "isUsable", { enumerable: true, get: function () { return status_1.isUsable; } });
46
+ var use_permission_1 = require("./permissions/use-permission");
47
+ Object.defineProperty(exports, "usePermission", { enumerable: true, get: function () { return use_permission_1.usePermission; } });
48
+ var Paywall_1 = require("./purchases/Paywall");
49
+ Object.defineProperty(exports, "Paywall", { enumerable: true, get: function () { return Paywall_1.Paywall; } });
50
+ var purchases_1 = require("./purchases/purchases");
51
+ Object.defineProperty(exports, "createPurchases", { enumerable: true, get: function () { return purchases_1.createPurchases; } });
52
+ var system_views_1 = require("./purchases/system-views");
53
+ Object.defineProperty(exports, "defaultPaywallLabels", { enumerable: true, get: function () { return system_views_1.defaultPaywallLabels; } });
54
+ Object.defineProperty(exports, "SystemBuyButton", { enumerable: true, get: function () { return system_views_1.SystemBuyButton; } });
55
+ Object.defineProperty(exports, "SystemProductRow", { enumerable: true, get: function () { return system_views_1.SystemProductRow; } });
56
+ Object.defineProperty(exports, "SystemPurchaseMessageAlert", { enumerable: true, get: function () { return system_views_1.SystemPurchaseMessageAlert; } });
57
+ Object.defineProperty(exports, "SystemRestoreButton", { enumerable: true, get: function () { return system_views_1.SystemRestoreButton; } });
58
+ var use_purchases_1 = require("./purchases/use-purchases");
59
+ Object.defineProperty(exports, "usePurchases", { enumerable: true, get: function () { return use_purchases_1.usePurchases; } });
60
+ var errors_1 = require("./screen-states/errors");
61
+ Object.defineProperty(exports, "isOfflineError", { enumerable: true, get: function () { return errors_1.isOfflineError; } });
62
+ var ScreenStates_1 = require("./screen-states/ScreenStates");
63
+ Object.defineProperty(exports, "ScreenStates", { enumerable: true, get: function () { return ScreenStates_1.ScreenStates; } });
64
+ var system_views_2 = require("./screen-states/system-views");
65
+ Object.defineProperty(exports, "defaultScreenStatesLabels", { enumerable: true, get: function () { return system_views_2.defaultScreenStatesLabels; } });
66
+ Object.defineProperty(exports, "SystemEmptyView", { enumerable: true, get: function () { return system_views_2.SystemEmptyView; } });
67
+ Object.defineProperty(exports, "SystemFailedView", { enumerable: true, get: function () { return system_views_2.SystemFailedView; } });
68
+ Object.defineProperty(exports, "SystemLoadingView", { enumerable: true, get: function () { return system_views_2.SystemLoadingView; } });
69
+ Object.defineProperty(exports, "SystemOfflineView", { enumerable: true, get: function () { return system_views_2.SystemOfflineView; } });
70
+ Object.defineProperty(exports, "SystemRefreshErrorAlert", { enumerable: true, get: function () { return system_views_2.SystemRefreshErrorAlert; } });
71
+ var use_screen_states_1 = require("./screen-states/use-screen-states");
72
+ Object.defineProperty(exports, "useScreenStates", { enumerable: true, get: function () { return use_screen_states_1.useScreenStates; } });
73
+ var labels_2 = require("./search/labels");
74
+ Object.defineProperty(exports, "defaultSearchLabels", { enumerable: true, get: function () { return labels_2.defaultSearchLabels; } });
75
+ var recent_searches_1 = require("./search/recent-searches");
76
+ Object.defineProperty(exports, "createInMemoryRecentSearches", { enumerable: true, get: function () { return recent_searches_1.createInMemoryRecentSearches; } });
77
+ var SearchResults_1 = require("./search/SearchResults");
78
+ Object.defineProperty(exports, "SearchResults", { enumerable: true, get: function () { return SearchResults_1.SearchResults; } });
79
+ var system_views_3 = require("./search/system-views");
80
+ Object.defineProperty(exports, "SystemNoResultsView", { enumerable: true, get: function () { return system_views_3.SystemNoResultsView; } });
81
+ Object.defineProperty(exports, "SystemRecentSearches", { enumerable: true, get: function () { return system_views_3.SystemRecentSearches; } });
82
+ var use_search_1 = require("./search/use-search");
83
+ Object.defineProperty(exports, "useSearch", { enumerable: true, get: function () { return use_search_1.useSearch; } });
84
+ var labels_3 = require("./selection/labels");
85
+ Object.defineProperty(exports, "defaultSelectionLabels", { enumerable: true, get: function () { return labels_3.defaultSelectionLabels; } });
86
+ var system_views_4 = require("./selection/system-views");
87
+ Object.defineProperty(exports, "SelectAllButton", { enumerable: true, get: function () { return system_views_4.SelectAllButton; } });
88
+ Object.defineProperty(exports, "SelectionModeButton", { enumerable: true, get: function () { return system_views_4.SelectionModeButton; } });
89
+ var use_selection_1 = require("./selection/use-selection");
90
+ Object.defineProperty(exports, "useSelection", { enumerable: true, get: function () { return use_selection_1.useSelection; } });
91
+ var use_sheet_1 = require("./sheets/use-sheet");
92
+ Object.defineProperty(exports, "defaultSheetLabels", { enumerable: true, get: function () { return use_sheet_1.defaultSheetLabels; } });
93
+ Object.defineProperty(exports, "modalSheet", { enumerable: true, get: function () { return use_sheet_1.modalSheet; } });
94
+ Object.defineProperty(exports, "useSheet", { enumerable: true, get: function () { return use_sheet_1.useSheet; } });
@@ -0,0 +1,47 @@
1
+ import { type ReactElement, type ReactNode } from "react";
2
+ import { type FlatListProps, type ListRenderItemInfo, type ScrollViewProps } from "react-native";
3
+ import { type FocusWhenLoaded, type ScreenStatesViews } from "../screen-states/ScreenStates";
4
+ import type { ScreenStatesLabels } from "../screen-states/system-views";
5
+ import type { SelectionController } from "../selection/use-selection";
6
+ import type { PagedListController } from "./controller";
7
+ import type { LoadPage, PagedListFooter } from "./machine";
8
+ import { type PagedListLabels } from "./system-footer";
9
+ import { type PagedListOptions } from "./use-paged-list";
10
+ /** The `FlatList` props the list sets itself. */
11
+ type OwnListProps = "data" | "renderItem" | "keyExtractor" | "onEndReached" | "refreshControl" | "ListFooterComponent" | "inverted" | "maintainVisibleContentPosition";
12
+ /** `FlatList`'s row info, and whether the row is the last item loaded so far: a rounded last card, say. */
13
+ export interface PagedListRenderItemInfo<Item> extends ListRenderItemInfo<Item> {
14
+ readonly isLast: boolean;
15
+ }
16
+ export interface PagedListProps<Item, Token> extends Omit<PagedListOptions<Item, Token>, "labels">, Omit<PagedListViewProps<Item>, "list" | "focusWhenLoaded" | "pullToRefreshProps"> {
17
+ readonly loadPage: LoadPage<Item, Token>;
18
+ }
19
+ /**
20
+ * A list of data that comes in pages, in a `FlatList` of the app's own rows: the first page as a screen state, the
21
+ * next page on `onEndReached`, and a footer after the last row while a page loads, when one fails, and at the end.
22
+ * Pull to refresh starts again from the first page. Items with a key already in the list are dropped. Any other
23
+ * prop goes to the `FlatList`. For a chat that takes new messages, keep the state yourself with `usePagedList`
24
+ * (`inverted: true`) and draw it with `PagedListView`.
25
+ */
26
+ export declare function PagedList<Item, Token>(props: PagedListProps<Item, Token>): import("react").JSX.Element;
27
+ /**
28
+ * The views of a paged list's controller, for `PagedList`, the behaviors built on it, and apps that keep the state
29
+ * themselves. An inverted controller is a chat: the newest row at the bottom, older pages above it, and newer items
30
+ * scrolling into view only when the newest row is on screen.
31
+ */
32
+ export interface PagedListViewProps<Item> extends Omit<ScreenStatesViews<readonly Item[]>, "content" | "labels">, Omit<FlatListProps<Item>, OwnListProps> {
33
+ readonly list: PagedListController<Item>;
34
+ readonly keyExtractor: (item: Item) => string;
35
+ readonly renderItem: (info: PagedListRenderItemInfo<Item>) => ReactElement | null;
36
+ /** After the last row. By default, a progress indicator, Try Again, Load More, or an end message. */
37
+ readonly footer?: (footer: PagedListFooter) => ReactNode;
38
+ /** The text of the views you leave out, and of the announcements. */
39
+ readonly labels?: Partial<ScreenStatesLabels & PagedListLabels>;
40
+ readonly focusWhenLoaded?: FocusWhenLoaded;
41
+ /** Props for the scroll view that lets the empty, failed and offline views be pulled to refresh. */
42
+ readonly pullToRefreshProps?: ScrollViewProps;
43
+ /** A selection kept to the items the list has loaded; rows redraw as it changes. */
44
+ readonly selection?: SelectionController<Item>;
45
+ }
46
+ export declare function PagedListView<Item>(props: PagedListViewProps<Item>): import("react").JSX.Element;
47
+ export {};
@@ -0,0 +1,81 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PagedList = PagedList;
4
+ exports.PagedListView = PagedListView;
5
+ const jsx_runtime_1 = require("react/jsx-runtime");
6
+ const react_1 = require("react");
7
+ const react_native_1 = require("react-native");
8
+ const ScreenStates_1 = require("../screen-states/ScreenStates");
9
+ const inverted_list_1 = require("./inverted-list");
10
+ const system_footer_1 = require("./system-footer");
11
+ const use_paged_list_1 = require("./use-paged-list");
12
+ const NO_ITEMS = [];
13
+ /**
14
+ * A list of data that comes in pages, in a `FlatList` of the app's own rows: the first page as a screen state, the
15
+ * next page on `onEndReached`, and a footer after the last row while a page loads, when one fails, and at the end.
16
+ * Pull to refresh starts again from the first page. Items with a key already in the list are dropped. Any other
17
+ * prop goes to the `FlatList`. For a chat that takes new messages, keep the state yourself with `usePagedList`
18
+ * (`inverted: true`) and draw it with `PagedListView`.
19
+ */
20
+ function PagedList(props) {
21
+ const { loadPage, isOffline, initialPage, inverted, ...viewProps } = props;
22
+ const { keyExtractor, labels } = viewProps;
23
+ const list = (0, use_paged_list_1.usePagedList)(loadPage, {
24
+ keyExtractor,
25
+ ...(isOffline && { isOffline }),
26
+ ...(labels && { labels }),
27
+ ...(initialPage && { initialPage }),
28
+ ...(inverted && { inverted }),
29
+ });
30
+ return (0, jsx_runtime_1.jsx)(PagedListView, { ...viewProps, list: list });
31
+ }
32
+ function PagedListView(props) {
33
+ checkThreshold(props.onEndReachedThreshold);
34
+ const { list, keyExtractor, renderItem, footer, labels, focusWhenLoaded, pullToRefreshProps, ...rest } = props;
35
+ const { loading, empty, failed, offline, refreshError, selection, ...listProps } = rest;
36
+ const { onViewableItemsChanged, viewabilityConfig, viewabilityConfigCallbackPairs, onScrollBeginDrag, ...others } = listProps;
37
+ const own = {
38
+ ...(onViewableItemsChanged && { onViewableItemsChanged }),
39
+ ...(viewabilityConfig && { viewabilityConfig }),
40
+ ...(viewabilityConfigCallbackPairs && { viewabilityConfigCallbackPairs }),
41
+ ...(onScrollBeginDrag && { onScrollBeginDrag }),
42
+ };
43
+ const direction = (0, inverted_list_1.useInvertedList)(list, own);
44
+ const loadedItems = knownItems(list.state);
45
+ const updateSelection = selection?.updateItems;
46
+ // Every render: updating is idempotent, and catches a changed `isDisabled` as well as new items.
47
+ (0, react_1.useLayoutEffect)(() => {
48
+ if (loadedItems !== undefined)
49
+ updateSelection?.(loadedItems);
50
+ });
51
+ const footerLabels = { ...system_footer_1.defaultPagedListLabels, ...labels };
52
+ const footerView = list.footer && ((0, jsx_runtime_1.jsx)(FooterView, { footer: list.footer, render: footer, labels: footerLabels, inverted: list.inverted }));
53
+ const views = {
54
+ ...(loading && { loading }),
55
+ ...(empty && { empty }),
56
+ ...(failed && { failed }),
57
+ ...(offline && { offline }),
58
+ ...(refreshError && { refreshError }),
59
+ ...(labels && { labels }),
60
+ content: (items, refreshControl) => ((0, jsx_runtime_1.jsx)(react_native_1.FlatList, { ...others, ...direction.props, ref: direction.ref, data: items,
61
+ // A new function each render, so rows redraw when the selection (or anything else) changes.
62
+ renderItem: (info) => renderItem({ ...info, isLast: info.index === items.length - 1 }), keyExtractor: keyExtractor, refreshControl: refreshControl, onEndReached: list.endReached, ListFooterComponent: footerView })),
63
+ };
64
+ return ((0, jsx_runtime_1.jsx)(ScreenStates_1.ScreenStatesView, { views: views, screen: list, ...(focusWhenLoaded && { focusWhenLoaded }), ...(pullToRefreshProps && { pullToRefreshProps }) }));
65
+ }
66
+ /** The items once the list has loaded: its content's, or none for the empty view. Until then, `undefined`. */
67
+ function knownItems(state) {
68
+ if (state.status === "content")
69
+ return state.value;
70
+ return state.status === "empty" ? NO_ITEMS : undefined;
71
+ }
72
+ function FooterView(props) {
73
+ const { footer, render, labels, inverted } = props;
74
+ return render ? (render(footer)) : ((0, jsx_runtime_1.jsx)(system_footer_1.SystemPagedListFooter, { footer: footer, labels: labels, inverted: inverted }));
75
+ }
76
+ /** `FlatList` reads `onEndReachedThreshold` in screen lengths from the end; below 0, it would never load more. */
77
+ function checkThreshold(threshold) {
78
+ if (threshold == null || (Number.isFinite(threshold) && threshold >= 0))
79
+ return;
80
+ throw new RangeError(`PagedList's onEndReachedThreshold must be 0 or more screen lengths, not ${threshold}.`);
81
+ }
@@ -0,0 +1,23 @@
1
+ import type { PagedListMachine, PagedListSnapshot } from "./machine";
2
+ export interface PagedListController<Item> extends PagedListSnapshot<Item> {
3
+ readonly retry: () => void;
4
+ readonly refresh: () => Promise<void>;
5
+ readonly dismissRefreshError: () => void;
6
+ /** The Load More action: loads the next page if there is one and nothing is loading, failed or refreshing. */
7
+ readonly loadMore: () => void;
8
+ /** For `FlatList`'s `onEndReached`: loads the next page as `loadMore` does, but never after pages that added nothing. */
9
+ readonly endReached: () => void;
10
+ readonly retryPage: () => void;
11
+ /** Newer items, oldest first, for the bottom of an inverted list (a message just received). */
12
+ readonly appendNewer: (items: readonly Item[]) => void;
13
+ /** Scrolls to the newest row and sets `newItemCount` back to 0: the app's "new items" indicator's action. */
14
+ readonly scrollToBottom: () => void;
15
+ /** For an app drawing an inverted list itself: call as the newest row comes on screen and goes off it. */
16
+ readonly bottomChanged: (isAtBottom: boolean) => void;
17
+ /** For an app drawing an inverted list itself: call from `onScrollBeginDrag`, so a drag ends a scroll to the bottom. */
18
+ readonly userScrolled: () => void;
19
+ /** Whether the list is a chat, drawn in an inverted `FlatList`. */
20
+ readonly inverted: boolean;
21
+ }
22
+ /** The machine's snapshot with its actions: what `usePagedList` returns, and what search gives each query. */
23
+ export declare function pagedListController<Item, Token>(machine: PagedListMachine<Item, Token>, snapshot: PagedListSnapshot<Item>): PagedListController<Item>;
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.pagedListController = pagedListController;
4
+ /** The machine's snapshot with its actions: what `usePagedList` returns, and what search gives each query. */
5
+ function pagedListController(machine, snapshot) {
6
+ return {
7
+ ...snapshot,
8
+ retry: machine.retry,
9
+ refresh: machine.refresh,
10
+ dismissRefreshError: machine.dismissRefreshError,
11
+ loadMore: machine.loadMore,
12
+ endReached: machine.endReached,
13
+ retryPage: machine.retryPage,
14
+ appendNewer: machine.appendNewer,
15
+ scrollToBottom: machine.scrollToBottom,
16
+ bottomChanged: machine.bottomChanged,
17
+ userScrolled: machine.userScrolled,
18
+ inverted: machine.inverted,
19
+ };
20
+ }
@@ -0,0 +1,23 @@
1
+ import type { FlatList, FlatListProps } from "react-native";
2
+ import type { PagedListController } from "./controller";
3
+ /** The app's own `FlatList` props an inverted list wraps. */
4
+ export type InvertedListProps<Item> = Pick<FlatListProps<Item>, "onViewableItemsChanged" | "viewabilityConfig" | "viewabilityConfigCallbackPairs" | "onScrollBeginDrag">;
5
+ /**
6
+ * The `FlatList` props that make a paged list a chat when it is inverted: it reports the newest row coming on and off
7
+ * screen and a drag starting, keeps the rows on screen still as rows arrive, and scrolls to the newest row when the
8
+ * list asks. A list that isn't inverted gets the app's own props back as they are.
9
+ */
10
+ export declare function useInvertedList<Item>(list: PagedListController<Item>, own: InvertedListProps<Item>): {
11
+ ref: import("react").RefObject<FlatList<Item> | null>;
12
+ props: InvertedListProps<Item>;
13
+ } | {
14
+ ref: import("react").RefObject<FlatList<Item> | null>;
15
+ props: {
16
+ inverted: boolean;
17
+ maintainVisibleContentPosition: {
18
+ minIndexForVisible: number;
19
+ };
20
+ viewabilityConfigCallbackPairs: import("@react-native/virtualized-lists").ViewabilityConfigCallbackPair[];
21
+ onScrollBeginDrag: (event: import("react-native").ScrollEvent) => void;
22
+ };
23
+ };
@@ -0,0 +1,60 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.useInvertedList = useInvertedList;
4
+ const react_1 = require("react");
5
+ /** The newest row counts as on screen when any of it shows. */
6
+ const BOTTOM_VIEWABILITY = { itemVisiblePercentThreshold: 1 };
7
+ /** Keeps the row on screen still as rows arrive before it: newer ones, below it in an inverted list. */
8
+ const KEEP_POSITION = { minIndexForVisible: 0 };
9
+ /**
10
+ * The `FlatList` props that make a paged list a chat when it is inverted: it reports the newest row coming on and off
11
+ * screen and a drag starting, keeps the rows on screen still as rows arrive, and scrolls to the newest row when the
12
+ * list asks. A list that isn't inverted gets the app's own props back as they are.
13
+ */
14
+ function useInvertedList(list, own) {
15
+ const ref = (0, react_1.useRef)(null);
16
+ const latest = (0, react_1.useRef)({ list, own });
17
+ (0, react_1.useEffect)(() => {
18
+ latest.current = { list, own };
19
+ });
20
+ // FlatList reads its viewability pairs once, so these read the latest props. The list's own pair has its own
21
+ // config, so the app's viewability settings never change what counts as the bottom.
22
+ const [pairs] = (0, react_1.useState)(() => [
23
+ {
24
+ viewabilityConfig: BOTTOM_VIEWABILITY,
25
+ onViewableItemsChanged: (info) => latest.current.list.bottomChanged(info.viewableItems.some((token) => token.index === 0)),
26
+ },
27
+ ...(own.viewabilityConfigCallbackPairs ?? []),
28
+ ...(own.onViewableItemsChanged
29
+ ? [
30
+ {
31
+ viewabilityConfig: own.viewabilityConfig ?? {},
32
+ onViewableItemsChanged: (info) => latest.current.own.onViewableItemsChanged?.(info),
33
+ },
34
+ ]
35
+ : []),
36
+ ]);
37
+ // Only requests made while this view is on screen: a view drawn again for a kept list doesn't jump to the bottom.
38
+ const handledRequest = (0, react_1.useRef)(list.scrollToBottomRequest);
39
+ (0, react_1.useEffect)(() => {
40
+ if (list.scrollToBottomRequest === handledRequest.current)
41
+ return;
42
+ handledRequest.current = list.scrollToBottomRequest;
43
+ ref.current?.scrollToOffset({ offset: 0, animated: true });
44
+ }, [list.scrollToBottomRequest]);
45
+ if (!list.inverted)
46
+ return { ref, props: own };
47
+ const onScrollBeginDrag = (event) => {
48
+ list.userScrolled();
49
+ own.onScrollBeginDrag?.(event);
50
+ };
51
+ return {
52
+ ref,
53
+ props: {
54
+ inverted: true,
55
+ maintainVisibleContentPosition: KEEP_POSITION,
56
+ viewabilityConfigCallbackPairs: pairs,
57
+ onScrollBeginDrag,
58
+ },
59
+ };
60
+ }
@@ -0,0 +1,81 @@
1
+ import { type Page } from "./paged-content";
2
+ import type { PagedListSnapshot, PagedListSource } from "./paged-list-types";
3
+ export type { LoadPage, PagedListAnnouncement, PagedListFooter, PagedListSnapshot, PagedListSource, } from "./paged-list-types";
4
+ /**
5
+ * The state machine behind `usePagedList`. The first page is a screen state; later pages load one at a time, and a
6
+ * refresh or `disappear()` aborts the one loading and drops its result. `source` is read when a load starts and
7
+ * ends, so it can change between renders.
8
+ */
9
+ export declare class PagedListMachine<Item, Token> {
10
+ private readonly source;
11
+ readonly inverted: boolean;
12
+ private readonly screen;
13
+ private pageLoad;
14
+ private generation;
15
+ private readonly listeners;
16
+ private readonly newest;
17
+ /** The newer items that arrived while the first page loads, for the page it brings, and whether each was shown. */
18
+ private arrivedDuringFirstPage;
19
+ private derived;
20
+ /**
21
+ * @param initialPage A first page the app already has, shown at once with no request. One with no items counts as
22
+ * none, and the first page loads.
23
+ * @param inverted A chat: the first page is the newest, at the bottom, with its items newest first.
24
+ */
25
+ constructor(source: () => PagedListSource<Item, Token>, initialPage?: Page<Item, Token>, inverted?: boolean);
26
+ readonly subscribe: (listener: () => void) => (() => void);
27
+ readonly getSnapshot: () => PagedListSnapshot<Item>;
28
+ /**
29
+ * Shows a first page at once with no request, even one with no items, which shows the empty view: for a behavior
30
+ * built on this one, such as search filtering items in memory. Does nothing once a load has started.
31
+ */
32
+ showLoaded(page: Page<Item, Token>): void;
33
+ /** Replaces the whole list shown with this first page, keeping the list itself (and its scroll position). */
34
+ replaceFirstPage(page: Page<Item, Token>): void;
35
+ /** Loads the first page. Safe to call on every mount: once it has started or finished, it does nothing. */
36
+ readonly appear: () => void;
37
+ /** Aborts the running load, of the first page or a later one, and drops its result. */
38
+ readonly disappear: () => void;
39
+ /** Loads the first page again from the failed or offline view. */
40
+ readonly retry: () => void;
41
+ /**
42
+ * Loads the first page again while the list stays on screen, and replaces the whole list with it if it succeeds.
43
+ * A page that is loading is aborted first. Resolves when the load finishes.
44
+ */
45
+ readonly refresh: () => Promise<void>;
46
+ readonly dismissRefreshError: () => void;
47
+ /** Loads the next page, if there is one and nothing is loading, failed or refreshing: the Load More action. */
48
+ readonly loadMore: () => void;
49
+ /**
50
+ * Loads the next page as the list nears its end (`FlatList`'s `onEndReached`), as `loadMore` does, except after
51
+ * pages that added nothing: then only `loadMore` goes on, so a server that keeps returning tokens can't loop.
52
+ */
53
+ readonly endReached: () => void;
54
+ /** Loads the page that failed again. */
55
+ readonly retryPage: () => void;
56
+ /**
57
+ * Adds items that arrived after the newest one (a message just received), oldest first, below the newest row.
58
+ * Items already in the list are dropped. When the newest row is on screen they scroll into view; otherwise the
59
+ * rows on screen stay still and `newItemCount` goes up. Only for an inverted list.
60
+ */
61
+ readonly appendNewer: (items: readonly Item[]) => void;
62
+ /** Scrolls to the newest row and sets `newItemCount` back to 0: the action of the app's "new items" indicator. */
63
+ readonly scrollToBottom: () => void;
64
+ /** Call as the newest row comes on screen and goes off it; `PagedList` does. */
65
+ readonly bottomChanged: (isAtBottom: boolean) => void;
66
+ /** Call when the user starts dragging the list (`onScrollBeginDrag`); `PagedList` does. */
67
+ readonly userScrolled: () => void;
68
+ private derive;
69
+ private footer;
70
+ /** The list on screen, when a page may load: never during a refresh. */
71
+ private shownContent;
72
+ private currentContent;
73
+ private loadFirstPage;
74
+ private startPageLoad;
75
+ private pageLoaded;
76
+ private pageFailed;
77
+ /** Ends the page load `id` and returns the list, unless a refresh or the screen going away replaced it. */
78
+ private finishPageLoad;
79
+ private cancelPageLoad;
80
+ private setPaging;
81
+ }