@twentyfirstmedia/ui-core 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,30 @@
+MIT License
+
+Copyright (c) 2026 Twentyfirst Media
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The kits bundle these fonts, each under the SIL Open Font License 1.1; their license
+files ship next to the fonts in each package's `dist/fonts`:
+
+- Plus Jakarta Sans (Halo)
+- IBM Plex Mono (Halo)
+- Geist and Geist Mono (Pro)

package/README.md

@@ -1,3 +1,32 @@
-# Temporary Holding Version
+# @twentyfirstmedia/ui-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The shared core of the [Twentyfirst UI](https://ui.twentyfirst.media) kits: every component, hook, icon and `Intl` formatter, plus `themes.css` with both kits.
+
+[Website](https://ui.twentyfirst.media) · [Halo docs](https://ui.twentyfirst.media/halo/) · [Pro docs](https://ui.twentyfirst.media/pro/) · [GitHub](https://github.com/twentyfirstmedia/ui) · [llms.txt](https://ui.twentyfirst.media/llms.txt)
+
+Most apps install a kit instead, [`@twentyfirstmedia/halo`](https://www.npmjs.com/package/@twentyfirstmedia/halo) or [`@twentyfirstmedia/pro`](https://www.npmjs.com/package/@twentyfirstmedia/pro), which re-export everything here together with the kit's styles.
+
+Install `ui-core` directly to load **both kits** and switch at runtime:
+
+```sh
+npm install @twentyfirstmedia/ui-core
+```
+
+```tsx
+import "@twentyfirstmedia/ui-core/themes.css";
+import { Button, UIProvider } from "@twentyfirstmedia/ui-core";
+
+export function App({ pro }: { pro: boolean }) {
+  return (
+    <UIProvider kit={pro ? "pro" : "halo"}>
+      <Button variant="primary">Save</Button>
+    </UIProvider>
+  );
+}
+```
+
+Markup, props and state stay the same; only the CSS that applies changes.
+
+## License
+
+[MIT](https://github.com/twentyfirstmedia/ui/blob/main/LICENSE) © Twentyfirst Media. Fonts under the SIL Open Font License 1.1.

package/dist/Icon.d.ts

@@ -0,0 +1,17 @@
+import type { CSSProperties } from "react";
+import { type IconName } from "./icons.js";
+export interface IconProps {
+    name: IconName;
+    /** Pixel size (default 16; 14 in chips and badges, 20 in navigation). */
+    size?: number;
+    /** Accessible name. Without it the icon is decorative and hidden from assistive tech. */
+    label?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+/** A line icon from the kit's set, drawn in `currentColor`. */
+export declare function Icon({ name, size, label, className, style }: IconProps): import("react").JSX.Element;
+export declare namespace Icon {
+    var names: ("thumbUp" | "thumbDown" | "arrowUp" | "heart" | "tag" | "cart" | "package" | "truck" | "plus" | "minus" | "check" | "x" | "more" | "search" | "bell" | "clock" | "eye" | "edit" | "trash" | "users" | "user" | "home" | "chart" | "mail" | "grid" | "share" | "menu" | "play" | "calendar" | "file" | "card" | "swap" | "send" | "download" | "book" | "chevronDown" | "chevronLeft" | "chevronRight" | "arrowUpRight" | "sparkle" | "filter" | "settings" | "lock" | "link" | "paperclip" | "star" | "flag" | "trend" | "globe" | "inbox" | "logout" | "moon" | "bot" | "code" | "branch" | "terminal" | "server" | "key" | "database" | "refresh" | "pause" | "archive" | "reply" | "shield" | "help" | "cpu" | "zap" | "folder" | "image" | "pin" | "map" | "upload" | "copy" | "bed" | "ruler" | "wallet" | "ban" | "list" | "layers" | "bold" | "italic" | "underline" | "olist" | "heading" | "quote" | "undo" | "redo" | "monitor" | "phone" | "expand" | "sun" | "cookie" | "webhook")[];
+}
+//# sourceMappingURL=Icon.d.ts.map

package/dist/Icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Icon.d.ts","sourceRoot":"","sources":["../src/Icon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,+DAA+D;AAC/D,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,IAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,SAAS,+BAoB3E;yBApBe,IAAI"}

package/dist/Icon.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cx } from "./cx.js";
+import { ICON_NAMES, ICON_PATHS } from "./icons.js";
+/** A line icon from the kit's set, drawn in `currentColor`. */
+export function Icon({ name, size = 16, label, className, style }) {
+    return (_jsx("svg", { className: cx("tf-ico", className), width: size, height: size, viewBox: "0 0 24 24", fill: name === "play" ? "currentColor" : "none", stroke: "currentColor", strokeWidth: name === "more" ? 3.2 : 2, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": label ? undefined : true, role: label ? "img" : undefined, "aria-label": label, style: { width: size, height: size, ...style }, children: _jsx("path", { d: ICON_PATHS[name] ?? ICON_PATHS.sparkle }) }));
+}
+Icon.names = ICON_NAMES;
+//# sourceMappingURL=Icon.js.map

package/dist/Icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Icon.js","sourceRoot":"","sources":["../src/Icon.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAYnE,+DAA+D;AAC/D,MAAM,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAa;IAC1E,OAAO,CACL,cACE,SAAS,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAClC,KAAK,EAAE,IAAI,EACX,MAAM,EAAE,IAAI,EACZ,OAAO,EAAC,WAAW,EACnB,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,EAC/C,MAAM,EAAC,cAAc,EACrB,WAAW,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EACtC,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,iBACT,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EACrC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,gBACnB,KAAK,EACjB,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,YAE9C,eAAM,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,OAAO,GAAI,GAC/C,CACP,CAAC;AACJ,CAAC;AACD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC"}

package/dist/components/admin.d.ts

@@ -0,0 +1,24 @@
+import * as React from "react";
+import type { BackupListProps, BalanceCardProps, BarListProps, BlockListProps, ColorFieldProps, CouponCardProps, ExportDialogProps, LiveFeedProps, LocaleFieldProps, LocaleSwitcherProps, MapViewProps, RangeSliderProps, ReviewCardProps, RunHistoryProps, ServiceMonitorProps, StatusSelectProps, TilePickerProps, TwoFactorSetupProps, WebhookEndpointProps, WorkspaceSwitcherProps } from "./types.js";
+export declare function RangeSlider(p: RangeSliderProps): React.JSX.Element;
+export declare function BarList(p: BarListProps): React.JSX.Element;
+export declare function StatusSelect(p: StatusSelectProps): React.JSX.Element;
+export declare function TilePicker(p: TilePickerProps): React.JSX.Element;
+export declare function LiveFeed(p: LiveFeedProps): React.JSX.Element;
+export declare function WorldDots(): React.JSX.Element;
+export declare function MapView(p: MapViewProps): React.JSX.Element;
+export declare function BalanceCard(p: BalanceCardProps): React.JSX.Element;
+export declare function ServiceMonitor(p: ServiceMonitorProps): React.JSX.Element;
+export declare function RunHistory(p: RunHistoryProps): React.JSX.Element;
+export declare function WebhookEndpoint(p: WebhookEndpointProps): React.JSX.Element;
+export declare function BackupList(p: BackupListProps): React.JSX.Element;
+export declare function BlockList(p: BlockListProps): React.JSX.Element;
+export declare function ReviewCard(p: ReviewCardProps): React.JSX.Element;
+export declare function CouponCard(p: CouponCardProps): React.JSX.Element;
+export declare function LocaleField(p: LocaleFieldProps): React.JSX.Element;
+export declare function LocaleSwitcher(p: LocaleSwitcherProps): React.JSX.Element;
+export declare function WorkspaceSwitcher(p: WorkspaceSwitcherProps): React.JSX.Element;
+export declare function ExportDialog(p: ExportDialogProps): React.JSX.Element | null;
+export declare function TwoFactorSetup(p: TwoFactorSetupProps): React.JSX.Element;
+export declare function ColorField(p: ColorFieldProps): React.JSX.Element;
+//# sourceMappingURL=admin.d.ts.map

package/dist/components/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/components/admin.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EAEf,iBAAiB,EAEjB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EAEnB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,mBAAmB,EAEnB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAGpB,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,qBA4F9C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,YAAY,qBA+CtC;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,iBAAiB,qBA0DhD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,qBAmE5C;AAGD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,aAAa,qBAgHxC;AAOD,wBAAgB,SAAS,sBAqBxB;AAID,wBAAgB,OAAO,CAAC,CAAC,EAAE,YAAY,qBAiGtC;AAKD,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,qBAsE9C;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,mBAAmB,qBAiCpD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,qBAwC5C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,oBAAoB,qBA4EtD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,qBA4C5C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,cAAc,qBAmE1C;AAKD,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,qBAoH5C;AAYD,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,qBA6E5C;AAGD,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,qBAgG9C;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,mBAAmB,qBAsGpD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,sBAAsB,qBAwF1D;AAKD,wBAAgB,YAAY,CAAC,CAAC,EAAE,iBAAiB,4BA6JhD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,mBAAmB,qBAiKpD;AAID,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,qBA2D5C"}