@stoa-dev/kit 0.1.4 → 1.0.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 (100) hide show
  1. package/CHANGELOG.md +64 -0
  2. package/README.md +23 -2
  3. package/dist/display/BarChart/index.js +70 -0
  4. package/dist/display/BarChart/index.js.map +1 -0
  5. package/dist/display/Marginalia/index.js +16 -0
  6. package/dist/display/Marginalia/index.js.map +1 -0
  7. package/dist/display/MarginaliaFramed/index.js +19 -0
  8. package/dist/display/MarginaliaFramed/index.js.map +1 -0
  9. package/dist/display/MarginaliaPair/index.js +32 -0
  10. package/dist/display/MarginaliaPair/index.js.map +1 -0
  11. package/dist/display/ProgressBar/index.js +72 -0
  12. package/dist/display/ProgressBar/index.js.map +1 -0
  13. package/dist/display/TimeMeasured/index.js +38 -0
  14. package/dist/display/TimeMeasured/index.js.map +1 -0
  15. package/dist/display/index.js +16 -0
  16. package/dist/display/index.js.map +1 -0
  17. package/dist/i18n/locales/at.json.js +8 -4
  18. package/dist/i18n/locales/at.json.js.map +1 -1
  19. package/dist/i18n/locales/de.json.js +8 -4
  20. package/dist/i18n/locales/de.json.js.map +1 -1
  21. package/dist/i18n/locales/en.json.js +8 -4
  22. package/dist/i18n/locales/en.json.js.map +1 -1
  23. package/dist/i18n/locales/it.json.js +10 -6
  24. package/dist/i18n/locales/it.json.js.map +1 -1
  25. package/dist/shell/AnimatedSwap/index.js +61 -0
  26. package/dist/shell/AnimatedSwap/index.js.map +1 -0
  27. package/dist/shell/AppNavigation/index.js +62 -43
  28. package/dist/shell/AppNavigation/index.js.map +1 -1
  29. package/dist/shell/BrandLines/index.js +14 -12
  30. package/dist/shell/BrandLines/index.js.map +1 -1
  31. package/dist/shell/DatePicker/index.js +16 -15
  32. package/dist/shell/DatePicker/index.js.map +1 -1
  33. package/dist/shell/ExternalLink/index.js +30 -0
  34. package/dist/shell/ExternalLink/index.js.map +1 -0
  35. package/dist/shell/PageHeading/index.js +15 -8
  36. package/dist/shell/PageHeading/index.js.map +1 -1
  37. package/dist/shell/SaveStatus/index.js +61 -0
  38. package/dist/shell/SaveStatus/index.js.map +1 -0
  39. package/dist/shell/SectionNavigation/index.js +29 -27
  40. package/dist/shell/SectionNavigation/index.js.map +1 -1
  41. package/dist/shell/StartupAnimation/index.js +88 -0
  42. package/dist/shell/StartupAnimation/index.js.map +1 -0
  43. package/dist/shell/StartupProvider/index.js +37 -0
  44. package/dist/shell/StartupProvider/index.js.map +1 -0
  45. package/dist/shell/TagInput/index.js +93 -0
  46. package/dist/shell/TagInput/index.js.map +1 -0
  47. package/dist/shell/ValidatedInput/index.js +31 -0
  48. package/dist/shell/ValidatedInput/index.js.map +1 -0
  49. package/dist/shell/index.js +41 -24
  50. package/dist/shell/index.js.map +1 -1
  51. package/dist/types/display/BarChart/index.d.ts +25 -0
  52. package/dist/types/display/BarChart/index.d.ts.map +1 -0
  53. package/dist/types/display/Marginalia/index.d.ts +8 -0
  54. package/dist/types/display/Marginalia/index.d.ts.map +1 -0
  55. package/dist/types/display/MarginaliaFramed/index.d.ts +8 -0
  56. package/dist/types/display/MarginaliaFramed/index.d.ts.map +1 -0
  57. package/dist/types/display/MarginaliaPair/index.d.ts +9 -0
  58. package/dist/types/display/MarginaliaPair/index.d.ts.map +1 -0
  59. package/dist/types/display/ProgressBar/index.d.ts +19 -0
  60. package/dist/types/display/ProgressBar/index.d.ts.map +1 -0
  61. package/dist/types/display/TimeMeasured/index.d.ts +16 -0
  62. package/dist/types/display/TimeMeasured/index.d.ts.map +1 -0
  63. package/dist/types/display/index.d.ts +7 -0
  64. package/dist/types/display/index.d.ts.map +1 -0
  65. package/dist/types/i18n/index.d.ts +44 -0
  66. package/dist/types/i18n/index.d.ts.map +1 -1
  67. package/dist/types/shell/AnimatedSwap/index.d.ts +13 -0
  68. package/dist/types/shell/AnimatedSwap/index.d.ts.map +1 -0
  69. package/dist/types/shell/AppNavigation/index.d.ts.map +1 -1
  70. package/dist/types/shell/BrandLines/index.d.ts.map +1 -1
  71. package/dist/types/shell/DatePicker/index.d.ts.map +1 -1
  72. package/dist/types/shell/ErrorBoundary/index.d.ts +1 -1
  73. package/dist/types/shell/ExternalLink/index.d.ts +10 -0
  74. package/dist/types/shell/ExternalLink/index.d.ts.map +1 -0
  75. package/dist/types/shell/PageHeading/index.d.ts.map +1 -1
  76. package/dist/types/shell/SaveStatus/index.d.ts +15 -0
  77. package/dist/types/shell/SaveStatus/index.d.ts.map +1 -0
  78. package/dist/types/shell/SectionNavigation/index.d.ts.map +1 -1
  79. package/dist/types/shell/StartupAnimation/index.d.ts +26 -0
  80. package/dist/types/shell/StartupAnimation/index.d.ts.map +1 -0
  81. package/dist/types/shell/StartupProvider/index.d.ts +22 -0
  82. package/dist/types/shell/StartupProvider/index.d.ts.map +1 -0
  83. package/dist/types/shell/TagInput/index.d.ts +20 -0
  84. package/dist/types/shell/TagInput/index.d.ts.map +1 -0
  85. package/dist/types/shell/ValidatedInput/index.d.ts +17 -0
  86. package/dist/types/shell/ValidatedInput/index.d.ts.map +1 -0
  87. package/dist/types/shell/index.d.ts +7 -0
  88. package/dist/types/shell/index.d.ts.map +1 -1
  89. package/dist/types/ui/field/index.d.ts +1 -1
  90. package/dist/types/utils/index.d.ts +1 -0
  91. package/dist/types/utils/index.d.ts.map +1 -1
  92. package/dist/types/utils/saveFeedback.d.ts +35 -0
  93. package/dist/types/utils/saveFeedback.d.ts.map +1 -0
  94. package/dist/utils/index.js +5 -3
  95. package/dist/utils/index.js.map +1 -1
  96. package/dist/utils/saveFeedback.js +54 -0
  97. package/dist/utils/saveFeedback.js.map +1 -0
  98. package/package.json +8 -2
  99. package/styles/instrument.css +705 -0
  100. package/styles/theme.css +1 -0
@@ -0,0 +1,35 @@
1
+ export type VisibleSaveStatus = 'saving' | 'saved' | 'error' | null;
2
+ /** What an autosave controller exposes to the feedback timing. */
3
+ export type FeedbackSource = {
4
+ readonly status: string;
5
+ readonly dirty: boolean;
6
+ /** Increments on every edit. */
7
+ readonly editRevision: number;
8
+ /** Increments on every successful save. */
9
+ readonly successfulSaves: number;
10
+ };
11
+ /**
12
+ * Decides when autosave feedback is shown: errors at once, "saving" only while
13
+ * leaving, "saved" only after a quiet minute so typing never flickers.
14
+ * Presentation timing only; never delays validation, persistence or navigation.
15
+ */
16
+ export declare class SaveFeedback {
17
+ private sources;
18
+ private notify;
19
+ private edits;
20
+ private successes;
21
+ private pending;
22
+ private quiet;
23
+ private leaving;
24
+ private timer?;
25
+ private hideTimer?;
26
+ private visible;
27
+ constructor(sources: FeedbackSource[], notify: (status: VisibleSaveStatus) => void);
28
+ private editCount;
29
+ private successCount;
30
+ private show;
31
+ setLeaving(value: boolean): void;
32
+ update: () => void;
33
+ dispose(): void;
34
+ }
35
+ //# sourceMappingURL=saveFeedback.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"saveFeedback.d.ts","sourceRoot":"","sources":["../../../src/utils/saveFeedback.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;AAEnE,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,gCAAgC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAChC,CAAA;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAUvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IAVf,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAC,CAA+B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAA+B;IACjD,OAAO,CAAC,OAAO,CAA0B;gBAEhC,OAAO,EAAE,cAAc,EAAE,EACzB,MAAM,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI;IAKpD,OAAO,CAAC,SAAS;IAGjB,OAAO,CAAC,YAAY;IAGpB,OAAO,CAAC,IAAI;IAKZ,UAAU,CAAC,KAAK,EAAE,OAAO;IAIzB,MAAM,aA8CL;IACD,OAAO;CAIP"}
@@ -1,12 +1,14 @@
1
1
  import { cn as r } from "./cn.js";
2
2
  import { parseHexColor as a } from "./colors.js";
3
- import { formatDate as f, formatTimestamp as p, getRuntimeLocale as i, isValidDate as x } from "./dates.js";
3
+ import { formatDate as f, formatTimestamp as p, getRuntimeLocale as x, isValidDate as i } from "./dates.js";
4
+ import { SaveFeedback as l } from "./saveFeedback.js";
4
5
  export {
6
+ l as SaveFeedback,
5
7
  r as cn,
6
8
  f as formatDate,
7
9
  p as formatTimestamp,
8
- i as getRuntimeLocale,
9
- x as isValidDate,
10
+ x as getRuntimeLocale,
11
+ i as isValidDate,
10
12
  a as parseHexColor
11
13
  };
12
14
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}
@@ -0,0 +1,54 @@
1
+ class h {
2
+ constructor(s, i) {
3
+ this.sources = s, this.notify = i, this.edits = this.editCount(), this.successes = this.successCount();
4
+ }
5
+ sources;
6
+ notify;
7
+ edits;
8
+ successes;
9
+ pending = !1;
10
+ quiet = !1;
11
+ leaving = !1;
12
+ timer;
13
+ hideTimer;
14
+ visible = null;
15
+ editCount() {
16
+ return this.sources.reduce((s, i) => s + i.editRevision, 0);
17
+ }
18
+ successCount() {
19
+ return this.sources.reduce((s, i) => s + i.successfulSaves, 0);
20
+ }
21
+ show(s) {
22
+ s !== this.visible && (this.visible = s, this.notify(s));
23
+ }
24
+ setLeaving(s) {
25
+ this.leaving = s, this.update();
26
+ }
27
+ update = () => {
28
+ const s = this.editCount(), i = this.successCount();
29
+ if (s !== this.edits && (this.edits = s, this.pending = !1, this.quiet = !1, clearTimeout(this.timer), clearTimeout(this.hideTimer), this.show(null), this.timer = setTimeout(() => {
30
+ this.quiet = !0, this.update();
31
+ }, 6e4)), i !== this.successes && (this.successes = i, this.pending = !0), this.sources.some((e) => e.status === "error")) {
32
+ clearTimeout(this.hideTimer), this.show("error");
33
+ return;
34
+ }
35
+ if (this.leaving) {
36
+ this.pending = !1, clearTimeout(this.hideTimer), this.show(
37
+ this.sources.some((e) => e.status === "saving") ? "saving" : null
38
+ );
39
+ return;
40
+ }
41
+ if ((this.visible === "saving" || this.visible === "error") && this.show(null), this.sources.some((e) => e.dirty)) {
42
+ this.visible === "saved" && this.show(null);
43
+ return;
44
+ }
45
+ this.quiet && this.pending && (this.pending = !1, this.show("saved"), clearTimeout(this.hideTimer), this.hideTimer = setTimeout(() => this.show(null), 1600));
46
+ };
47
+ dispose() {
48
+ clearTimeout(this.timer), clearTimeout(this.hideTimer);
49
+ }
50
+ }
51
+ export {
52
+ h as SaveFeedback
53
+ };
54
+ //# sourceMappingURL=saveFeedback.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"saveFeedback.js","sources":["../../src/utils/saveFeedback.ts"],"sourcesContent":["export type VisibleSaveStatus = 'saving' | 'saved' | 'error' | null\n\n/** What an autosave controller exposes to the feedback timing. */\nexport type FeedbackSource = {\n\treadonly status: string\n\treadonly dirty: boolean\n\t/** Increments on every edit. */\n\treadonly editRevision: number\n\t/** Increments on every successful save. */\n\treadonly successfulSaves: number\n}\n\n/**\n * Decides when autosave feedback is shown: errors at once, \"saving\" only while\n * leaving, \"saved\" only after a quiet minute so typing never flickers.\n * Presentation timing only; never delays validation, persistence or navigation.\n */\nexport class SaveFeedback {\n\tprivate edits: number\n\tprivate successes: number\n\tprivate pending = false\n\tprivate quiet = false\n\tprivate leaving = false\n\tprivate timer?: ReturnType<typeof setTimeout>\n\tprivate hideTimer?: ReturnType<typeof setTimeout>\n\tprivate visible: VisibleSaveStatus = null\n\tconstructor(\n\t\tprivate sources: FeedbackSource[],\n\t\tprivate notify: (status: VisibleSaveStatus) => void,\n\t) {\n\t\tthis.edits = this.editCount()\n\t\tthis.successes = this.successCount()\n\t}\n\tprivate editCount() {\n\t\treturn this.sources.reduce((sum, source) => sum + source.editRevision, 0)\n\t}\n\tprivate successCount() {\n\t\treturn this.sources.reduce((sum, source) => sum + source.successfulSaves, 0)\n\t}\n\tprivate show(status: VisibleSaveStatus) {\n\t\tif (status === this.visible) return\n\t\tthis.visible = status\n\t\tthis.notify(status)\n\t}\n\tsetLeaving(value: boolean) {\n\t\tthis.leaving = value\n\t\tthis.update()\n\t}\n\tupdate = () => {\n\t\tconst edits = this.editCount()\n\t\tconst successes = this.successCount()\n\t\tif (edits !== this.edits) {\n\t\t\tthis.edits = edits\n\t\t\tthis.pending = false\n\t\t\tthis.quiet = false\n\t\t\tclearTimeout(this.timer)\n\t\t\tclearTimeout(this.hideTimer)\n\t\t\tthis.show(null)\n\t\t\tthis.timer = setTimeout(() => {\n\t\t\t\tthis.quiet = true\n\t\t\t\tthis.update()\n\t\t\t}, 60_000)\n\t\t}\n\t\tif (successes !== this.successes) {\n\t\t\tthis.successes = successes\n\t\t\tthis.pending = true\n\t\t}\n\t\tif (this.sources.some((source) => source.status === 'error')) {\n\t\t\tclearTimeout(this.hideTimer)\n\t\t\tthis.show('error')\n\t\t\treturn\n\t\t}\n\t\tif (this.leaving) {\n\t\t\t// The leave action itself gives feedback; don't repeat that success after 60 s.\n\t\t\tthis.pending = false\n\t\t\tclearTimeout(this.hideTimer)\n\t\t\tthis.show(\n\t\t\t\tthis.sources.some((source) => source.status === 'saving')\n\t\t\t\t\t? 'saving'\n\t\t\t\t\t: null,\n\t\t\t)\n\t\t\treturn\n\t\t}\n\t\tif (this.visible === 'saving' || this.visible === 'error') this.show(null)\n\t\tif (this.sources.some((source) => source.dirty)) {\n\t\t\tif (this.visible === 'saved') this.show(null)\n\t\t\treturn\n\t\t}\n\t\tif (this.quiet && this.pending) {\n\t\t\tthis.pending = false\n\t\t\tthis.show('saved')\n\t\t\tclearTimeout(this.hideTimer)\n\t\t\tthis.hideTimer = setTimeout(() => this.show(null), 1600)\n\t\t}\n\t}\n\tdispose() {\n\t\tclearTimeout(this.timer)\n\t\tclearTimeout(this.hideTimer)\n\t}\n}\n"],"names":["SaveFeedback","sources","notify","sum","source","status","value","edits","successes"],"mappings":"AAiBO,MAAMA,EAAa;AAAA,EASzB,YACSC,GACAC,GACP;AAFO,SAAA,UAAAD,GACA,KAAA,SAAAC,GAER,KAAK,QAAQ,KAAK,UAAA,GAClB,KAAK,YAAY,KAAK,aAAA;AAAA,EACvB;AAAA,EALS;AAAA,EACA;AAAA,EAVD;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,UAAU;AAAA,EACV;AAAA,EACA;AAAA,EACA,UAA6B;AAAA,EAQ7B,YAAY;AACnB,WAAO,KAAK,QAAQ,OAAO,CAACC,GAAKC,MAAWD,IAAMC,EAAO,cAAc,CAAC;AAAA,EACzE;AAAA,EACQ,eAAe;AACtB,WAAO,KAAK,QAAQ,OAAO,CAACD,GAAKC,MAAWD,IAAMC,EAAO,iBAAiB,CAAC;AAAA,EAC5E;AAAA,EACQ,KAAKC,GAA2B;AACvC,IAAIA,MAAW,KAAK,YACpB,KAAK,UAAUA,GACf,KAAK,OAAOA,CAAM;AAAA,EACnB;AAAA,EACA,WAAWC,GAAgB;AAC1B,SAAK,UAAUA,GACf,KAAK,OAAA;AAAA,EACN;AAAA,EACA,SAAS,MAAM;AACd,UAAMC,IAAQ,KAAK,UAAA,GACbC,IAAY,KAAK,aAAA;AAiBvB,QAhBID,MAAU,KAAK,UAClB,KAAK,QAAQA,GACb,KAAK,UAAU,IACf,KAAK,QAAQ,IACb,aAAa,KAAK,KAAK,GACvB,aAAa,KAAK,SAAS,GAC3B,KAAK,KAAK,IAAI,GACd,KAAK,QAAQ,WAAW,MAAM;AAC7B,WAAK,QAAQ,IACb,KAAK,OAAA;AAAA,IACN,GAAG,GAAM,IAENC,MAAc,KAAK,cACtB,KAAK,YAAYA,GACjB,KAAK,UAAU,KAEZ,KAAK,QAAQ,KAAK,CAACJ,MAAWA,EAAO,WAAW,OAAO,GAAG;AAC7D,mBAAa,KAAK,SAAS,GAC3B,KAAK,KAAK,OAAO;AACjB;AAAA,IACD;AACA,QAAI,KAAK,SAAS;AAEjB,WAAK,UAAU,IACf,aAAa,KAAK,SAAS,GAC3B,KAAK;AAAA,QACJ,KAAK,QAAQ,KAAK,CAACA,MAAWA,EAAO,WAAW,QAAQ,IACrD,WACA;AAAA,MAAA;AAEJ;AAAA,IACD;AAEA,SADI,KAAK,YAAY,YAAY,KAAK,YAAY,YAAS,KAAK,KAAK,IAAI,GACrE,KAAK,QAAQ,KAAK,CAACA,MAAWA,EAAO,KAAK,GAAG;AAChD,MAAI,KAAK,YAAY,WAAS,KAAK,KAAK,IAAI;AAC5C;AAAA,IACD;AACA,IAAI,KAAK,SAAS,KAAK,YACtB,KAAK,UAAU,IACf,KAAK,KAAK,OAAO,GACjB,aAAa,KAAK,SAAS,GAC3B,KAAK,YAAY,WAAW,MAAM,KAAK,KAAK,IAAI,GAAG,IAAI;AAAA,EAEzD;AAAA,EACA,UAAU;AACT,iBAAa,KAAK,KAAK,GACvB,aAAa,KAAK,SAAS;AAAA,EAC5B;AACD;"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@stoa-dev/kit",
3
- "version": "0.1.4",
3
+ "version": "1.0.0",
4
4
  "description": "Shared React components, hooks, utilities, licensing UI and theme for STOA desktop apps",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -21,7 +21,8 @@
21
21
  "dist",
22
22
  "styles",
23
23
  "scss",
24
- "README.md"
24
+ "README.md",
25
+ "CHANGELOG.md"
25
26
  ],
26
27
  "exports": {
27
28
  "./ui": {
@@ -32,6 +33,10 @@
32
33
  "types": "./dist/types/shell/index.d.ts",
33
34
  "import": "./dist/shell/index.js"
34
35
  },
36
+ "./display": {
37
+ "types": "./dist/types/display/index.d.ts",
38
+ "import": "./dist/display/index.js"
39
+ },
35
40
  "./licensing": {
36
41
  "types": "./dist/types/licensing/index.d.ts",
37
42
  "import": "./dist/licensing/index.js"
@@ -50,6 +55,7 @@
50
55
  },
51
56
  "./styles.css": "./dist/kit.css",
52
57
  "./theme.css": "./styles/theme.css",
58
+ "./instrument.css": "./styles/instrument.css",
53
59
  "./scss": {
54
60
  "sass": "./scss/_index.scss",
55
61
  "default": "./scss/_index.scss"