@singlebase/elements 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Singlebase
+
+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.

package/README.md

@@ -0,0 +1,29 @@
+# @singlebase/elements
+
+Singlebase web components, framework-free:
+
+- `<singlebase-authui>` and friends — sign-in, sign-up, codes, OAuth and the account view
+- `<singlebase-uploader>` — pick, check and upload files straight to storage
+
+```bash
+npm install @singlebase/elements @singlebase/singlebase-sdk
+```
+
+```js
+import "@singlebase/elements";            // everything
+import "@singlebase/elements/authui";     // auth elements only
+import "@singlebase/elements/uploader";   // uploader only
+```
+
+Or with no build step:
+
+```html
+<script type="module"
+  src="https://cdn.jsdelivr.net/npm/@singlebase/elements/dist/singlebase-elements.min.js"
+  data-singlebase-url-access-key="YOUR_PROJECT_KEY"
+  data-singlebase-api-key="wk_YOUR_WEB_KEY"></script>
+
+<singlebase-authui></singlebase-authui>
+```
+
+Documentation: https://github.com/singlebase/singlebase-js

package/dist/authui.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./display-CLDNNZQy.cjs"),r=require("./uploader-eFYKpk8b.cjs"),t=require("@singlebase/core");exports.AuthController=e.AuthController;exports.SettingsController=e.SettingsController;Object.defineProperty(exports,"SinglebaseAccountScreen",{enumerable:!0,get:()=>e.SinglebaseAccountScreen});Object.defineProperty(exports,"SinglebaseAuthButtons",{enumerable:!0,get:()=>e.SinglebaseAuthButtons});Object.defineProperty(exports,"SinglebaseAuthDisplay",{enumerable:!0,get:()=>e.SinglebaseAuthDisplay});Object.defineProperty(exports,"SinglebaseAuthGuard",{enumerable:!0,get:()=>e.SinglebaseAuthGuard});Object.defineProperty(exports,"SinglebaseAuthScreen",{enumerable:!0,get:()=>e.SinglebaseAuthScreen});exports.defaultMessages=e.defaultMessages;exports.fullNameOf=e.fullNameOf;exports.initialsOf=e.initialsOf;exports.isGuestScreen=e.isGuestScreen;exports.isProtectedScreen=e.isProtectedScreen;exports.isScreen=e.isScreen;exports.resolveMessages=e.resolveMessages;exports.resolveRedirectTarget=r.resolveRedirectTarget;Object.defineProperty(exports,"OPERATORS",{enumerable:!0,get:()=>t.OPERATORS});Object.defineProperty(exports,"matchesPredicate",{enumerable:!0,get:()=>t.matchesPredicate});Object.defineProperty(exports,"validatePredicate",{enumerable:!0,get:()=>t.validatePredicate});
+//# sourceMappingURL=authui.cjs.map

package/dist/authui.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authui.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/authui.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `@singlebase/elements/authui` — the authentication elements on their own:
+ * <singlebase-authui>, <singlebase-authui-guard>, <singlebase-authui-buttons>
+ * and <singlebase-authui-display>. Importing it registers them.
+ */
+export { SinglebaseAuthScreen } from "./elements/auth-screen.js";
+export type { Screen, GuestScreen, ProtectedScreen } from "./elements/auth-screen.js";
+export { isScreen, isGuestScreen, isProtectedScreen } from "./elements/auth-screen.js";
+export { SinglebaseAuthGuard } from "./elements/guard.js";
+export type { GuardState } from "./elements/guard.js";
+export { SinglebaseAuthButtons } from "./elements/buttons.js";
+export type { ButtonsType } from "./elements/buttons.js";
+export { SinglebaseAuthDisplay } from "./elements/display.js";
+export { SinglebaseAccountScreen } from "./elements/account-screen.js";
+export { AuthController } from "./controllers/auth-controller.js";
+export { SettingsController } from "./controllers/settings-controller.js";
+export { defaultMessages, resolveMessages } from "./messages.js";
+export type { SinglebaseAuthMessages } from "./messages.js";
+export { fullNameOf, initialsOf } from "./utils/profile.js";
+export { resolveRedirectTarget } from "./utils/redirect.js";
+export { matchesPredicate, validatePredicate, OPERATORS } from "@singlebase/core";
+export type { Predicate, Operator } from "@singlebase/core";

package/dist/authui.js

@@ -0,0 +1,24 @@
+import { A as a, S as t, a as r, b as i, c as l, d as n, e as o, f as c, g as S, i as u, h as g, j as d, k as f, r as A } from "./display-8HEcKYR4.js";
+import { r as b } from "./uploader-D-Da1trc.js";
+import { OPERATORS as p, matchesPredicate as O, validatePredicate as P } from "@singlebase/core";
+export {
+  a as AuthController,
+  p as OPERATORS,
+  t as SettingsController,
+  r as SinglebaseAccountScreen,
+  i as SinglebaseAuthButtons,
+  l as SinglebaseAuthDisplay,
+  n as SinglebaseAuthGuard,
+  o as SinglebaseAuthScreen,
+  c as defaultMessages,
+  S as fullNameOf,
+  u as initialsOf,
+  g as isGuestScreen,
+  d as isProtectedScreen,
+  f as isScreen,
+  O as matchesPredicate,
+  A as resolveMessages,
+  b as resolveRedirectTarget,
+  P as validatePredicate
+};
+//# sourceMappingURL=authui.js.map

package/dist/authui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authui.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/controllers/auth-controller.d.ts

@@ -0,0 +1,17 @@
+import type { ReactiveController, ReactiveControllerHost } from "lit";
+import type { AuthClient, AuthState } from "@singlebase/singlebase-sdk";
+/**
+ * Subscribes a host element to an AuthClient's session state and triggers a
+ * re-render on every change, so individual elements never hand-roll
+ * subscribe/unsubscribe bookkeeping. Call bind(client) whenever the host's
+ * resolved client changes (e.g. context updates, or .client is set).
+ */
+export declare class AuthController implements ReactiveController {
+    private host;
+    private client;
+    private unsubscribe;
+    state: AuthState;
+    constructor(host: ReactiveControllerHost);
+    bind(client: AuthClient | null): void;
+    hostDisconnected(): void;
+}

package/dist/controllers/event-bridge.d.ts

@@ -0,0 +1,27 @@
+import type { ReactiveController, ReactiveControllerHost } from "lit";
+import type { AuthClient } from "@singlebase/singlebase-sdk";
+export declare const BRIDGED_EVENTS: readonly ["load", "success", "error", "signin", "signup", "signout", "session", "account-updated", "password-change", "email-change", "username-change", "expired", "navigate", "goto"];
+/** "account-updated" -> "onAccountUpdated" */
+export declare function callbackPropFor(event: string): string;
+/**
+ * Re-publishes core auth events on the host element in the two ways host
+ * apps actually consume them:
+ *
+ *  - a DOM CustomEvent (`singlebase-signin`, and the spec's `auth:signin`),
+ *    bubbling and composed so `document.addEventListener` works;
+ *  - a callback property (`el.onSignin = fn`), since HTML attributes cannot
+ *    carry functions.
+ *
+ * Event details never include tokens — consumers read the session through
+ * the client, per the spec's events rule.
+ */
+export declare class EventBridge implements ReactiveController {
+    private host;
+    private unsubscribes;
+    private client;
+    constructor(host: ReactiveControllerHost & HTMLElement);
+    bind(client: AuthClient | null): void;
+    private publish;
+    private release;
+    hostDisconnected(): void;
+}

package/dist/controllers/settings-controller.d.ts

@@ -0,0 +1,18 @@
+import type { ReactiveController, ReactiveControllerHost } from "lit";
+import type { AuthClient, AuthSettings } from "@singlebase/singlebase-sdk";
+/**
+ * Loads auth.settings once per bound client and caches it, so composing
+ * many form elements inside <singlebase-authui> doesn't mean many redundant
+ * auth.settings calls. Each element may also be given .settings directly
+ * (e.g. by a parent that already loaded them) to skip the fetch entirely.
+ */
+export declare class SettingsController implements ReactiveController {
+    private host;
+    private client;
+    private cache;
+    settings: AuthSettings | null;
+    error: unknown;
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    load(client: AuthClient | null, override?: AuthSettings | null): void;
+}