@pindoba/core-badge 0.0.0-alpha-20260320034942

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright 2025 Eduardo Lopes
+
+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/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { BadgeApi, BadgeBaseProps, BadgeClasses, BadgeEmphasis, BadgeFeedback, BadgePassThrough, BadgeRootProps, BadgeSize, BadgeSlotPassThrough, ConnectBadgeOptions, ElementAttributes } from "./src/types.js";
+import { badgeDefaults, connectBadge } from "./src/connect-badge.js";
+export { type BadgeApi, type BadgeBaseProps, type BadgeClasses, type BadgeEmphasis, type BadgeFeedback, type BadgePassThrough, type BadgeRootProps, type BadgeSize, type BadgeSlotPassThrough, type ConnectBadgeOptions, type ElementAttributes, badgeDefaults, connectBadge };

package/dist/index.js

@@ -0,0 +1,2 @@
+import { badgeDefaults, connectBadge } from "./src/connect-badge.js";
+export { badgeDefaults, connectBadge };

package/dist/src/connect-badge.d.ts

@@ -0,0 +1,12 @@
+import { BadgeApi, ConnectBadgeOptions } from "./types.js";
+
+//#region src/connect-badge.d.ts
+declare const badgeDefaults: {
+  readonly emphasis: "primary";
+  readonly size: "md";
+  readonly feedback: "primary";
+};
+declare function connectBadge(options: ConnectBadgeOptions): BadgeApi;
+//#endregion
+export { badgeDefaults, connectBadge };
+//# sourceMappingURL=connect-badge.d.ts.map

package/dist/src/connect-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-badge.d.ts","names":[],"sources":["../../src/connect-badge.ts"],"mappings":";;;cAWa,aAAA;EAAA;;;;iBAMG,YAAA,CAAa,OAAA,EAAS,mBAAA,GAAsB,QAAA"}

package/dist/src/connect-badge.js

@@ -0,0 +1,55 @@
+import { css } from "@pindoba/styled-system/css";
+import { badgeStyles } from "@pindoba/styles-badge";
+import { panelStyles } from "@pindoba/styles-panel";
+//#region src/connect-badge.ts
+const badgeDefaults = {
+	emphasis: "primary",
+	size: "md",
+	feedback: "primary"
+};
+function connectBadge(options) {
+	const { feedback = badgeDefaults.feedback, emphasis = badgeDefaults.emphasis, size = badgeDefaults.size, buttonFit = true, svgFit = true, background, border, translucent, passThrough, class: className, ...restProps } = options;
+	const classes = badgeStyles.raw({
+		feedback,
+		emphasis,
+		size,
+		buttonFit: buttonFit || void 0,
+		svgFit: svgFit || void 0
+	});
+	let panelBase = {};
+	if (feedback === "neutral") {
+		const resolvedBackground = background ?? "surface";
+		const resolvedBorder = border ?? (emphasis === "secondary" ? "muted" : "none");
+		const { root: panelRoot } = panelStyles.raw({
+			emphasis: "secondary",
+			background: resolvedBackground,
+			accent: false,
+			feedback: "neutral",
+			border: resolvedBorder,
+			translucent: translucent ?? false,
+			radius: "none",
+			padding: "none",
+			interactive: false
+		});
+		const { color: _color, display: _display, flexDirection: _flexDir, width: _w, transition: _t, borderRadius: _br, borderTopLeftRadius: _btlr, borderTopRightRadius: _btrr, borderBottomLeftRadius: _bblr, borderBottomRightRadius: _bbrr, padding: _p, ...extracted } = panelRoot ?? {};
+		panelBase = extracted;
+	}
+	const generatedClass = css(classes.root, panelBase, passThrough?.root?.style);
+	const userClass = className != null ? String(className) : void 0;
+	return {
+		rootProps: {
+			...restProps,
+			...passThrough?.root?.props,
+			"data-component": "badge",
+			class: userClass ? `${generatedClass} ${userClass}` : generatedClass
+		},
+		classes: {
+			label: css(classes.label, passThrough?.label?.style),
+			content: css(classes.content, passThrough?.content?.style)
+		}
+	};
+}
+//#endregion
+export { badgeDefaults, connectBadge };
+
+//# sourceMappingURL=connect-badge.js.map

package/dist/src/connect-badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-badge.js","names":[],"sources":["../../src/connect-badge.ts"],"sourcesContent":["import { css } from \"@pindoba/styled-system/css\";\nimport type { SystemStyleObject } from \"@pindoba/styled-system/types\";\nimport { badgeStyles } from \"@pindoba/styles-badge\";\nimport { panelStyles } from \"@pindoba/styles-panel\";\nimport type {\n  BadgeApi,\n  BadgeBaseProps,\n  BadgeRootProps,\n  ConnectBadgeOptions,\n} from \"./types.js\";\n\nexport const badgeDefaults = {\n  emphasis: \"primary\",\n  size: \"md\",\n  feedback: \"primary\",\n} as const satisfies Partial<BadgeBaseProps>;\n\nexport function connectBadge(options: ConnectBadgeOptions): BadgeApi {\n  const {\n    feedback = badgeDefaults.feedback,\n    emphasis = badgeDefaults.emphasis,\n    size = badgeDefaults.size,\n    buttonFit = true,\n    svgFit = true,\n    background,\n    border,\n    translucent,\n    passThrough,\n    class: className,\n    ...restProps\n  } = options;\n\n  const classes = badgeStyles.raw({\n    feedback,\n    emphasis,\n    size,\n    buttonFit: buttonFit || undefined,\n    svgFit: svgFit || undefined,\n  });\n\n  // For neutral feedback, use panel as a surface base — same approach as button's secondary emphasis.\n  // Panel owns: background token, boxShadow CSS vars (--panel-elevation + --panel-border), translucent effects.\n  // Badge owns: color, display, borderRadius, padding — those are stripped before merging.\n  let panelBase: SystemStyleObject = {};\n  if (feedback === \"neutral\") {\n    const resolvedBackground = background ?? \"surface\";\n    // Secondary emphasis gets a muted ring by default; primary gets none.\n    const resolvedBorder =\n      border ?? (emphasis === \"secondary\" ? \"muted\" : \"none\");\n\n    const { root: panelRoot } = panelStyles.raw({\n      emphasis: \"secondary\",\n      background: resolvedBackground,\n      accent: false,\n      feedback: \"neutral\",\n      border: resolvedBorder,\n      translucent: translucent ?? false,\n      radius: \"none\",\n      padding: \"none\",\n      interactive: false,\n    });\n\n    const {\n      // Badge handles these itself\n      color: _color,\n      display: _display,\n      flexDirection: _flexDir,\n      width: _w,\n      transition: _t,\n      borderRadius: _br,\n      borderTopLeftRadius: _btlr,\n      borderTopRightRadius: _btrr,\n      borderBottomLeftRadius: _bblr,\n      borderBottomRightRadius: _bbrr,\n      padding: _p,\n      ...extracted\n    } = (panelRoot ?? {}) as Record<string, unknown>;\n\n    panelBase = extracted as SystemStyleObject;\n  }\n\n  const generatedClass = css(classes.root, panelBase, passThrough?.root?.style);\n  const userClass = className != null ? String(className) : undefined;\n\n  const rootProps: BadgeRootProps = {\n    ...restProps,\n    ...passThrough?.root?.props,\n    \"data-component\": \"badge\",\n    class: userClass ? `${generatedClass} ${userClass}` : generatedClass,\n  };\n\n  return {\n    rootProps,\n    classes: {\n      label: css(classes.label, passThrough?.label?.style),\n      content: css(classes.content, passThrough?.content?.style),\n    },\n  };\n}\n"],"mappings":";;;;AAWA,MAAa,gBAAgB;CAC3B,UAAU;CACV,MAAM;CACN,UAAU;CACX;AAED,SAAgB,aAAa,SAAwC;CACnE,MAAM,EACJ,WAAW,cAAc,UACzB,WAAW,cAAc,UACzB,OAAO,cAAc,MACrB,YAAY,MACZ,SAAS,MACT,YACA,QACA,aACA,aACA,OAAO,WACP,GAAG,cACD;CAEJ,MAAM,UAAU,YAAY,IAAI;EAC9B;EACA;EACA;EACA,WAAW,aAAa,KAAA;EACxB,QAAQ,UAAU,KAAA;EACnB,CAAC;CAKF,IAAI,YAA+B,EAAE;AACrC,KAAI,aAAa,WAAW;EAC1B,MAAM,qBAAqB,cAAc;EAEzC,MAAM,iBACJ,WAAW,aAAa,cAAc,UAAU;EAElD,MAAM,EAAE,MAAM,cAAc,YAAY,IAAI;GAC1C,UAAU;GACV,YAAY;GACZ,QAAQ;GACR,UAAU;GACV,QAAQ;GACR,aAAa,eAAe;GAC5B,QAAQ;GACR,SAAS;GACT,aAAa;GACd,CAAC;EAEF,MAAM,EAEJ,OAAO,QACP,SAAS,UACT,eAAe,UACf,OAAO,IACP,YAAY,IACZ,cAAc,KACd,qBAAqB,OACrB,sBAAsB,OACtB,wBAAwB,OACxB,yBAAyB,OACzB,SAAS,IACT,GAAG,cACA,aAAa,EAAE;AAEpB,cAAY;;CAGd,MAAM,iBAAiB,IAAI,QAAQ,MAAM,WAAW,aAAa,MAAM,MAAM;CAC7E,MAAM,YAAY,aAAa,OAAO,OAAO,UAAU,GAAG,KAAA;AAS1D,QAAO;EACL,WARgC;GAChC,GAAG;GACH,GAAG,aAAa,MAAM;GACtB,kBAAkB;GAClB,OAAO,YAAY,GAAG,eAAe,GAAG,cAAc;GACvD;EAIC,SAAS;GACP,OAAO,IAAI,QAAQ,OAAO,aAAa,OAAO,MAAM;GACpD,SAAS,IAAI,QAAQ,SAAS,aAAa,SAAS,MAAM;GAC3D;EACF"}

package/dist/src/types.d.ts

@@ -0,0 +1,81 @@
+import { BadgeStyleProps } from "@pindoba/styles-badge";
+import { PanelStyleProps } from "@pindoba/styles-panel";
+import { SystemStyleObject } from "@pindoba/styled-system/types";
+
+//#region src/types.d.ts
+type ElementAttributes = Partial<Record<string, unknown>>;
+type BadgeFeedback = NonNullable<BadgeStyleProps["feedback"]>;
+type BadgeEmphasis = NonNullable<BadgeStyleProps["emphasis"]>;
+type BadgeSize = NonNullable<BadgeStyleProps["size"]>;
+/** Background values accepted by the badge (panel backgrounds, `feedback="neutral"` only). */
+type BadgeBackground = NonNullable<PanelStyleProps["background"]>;
+/** Border ring values accepted by the badge (panel borders, `feedback="neutral"` only). */
+type BadgeBorder = NonNullable<PanelStyleProps["border"]>;
+interface BadgeSlotPassThrough<T = ElementAttributes> {
+  style?: SystemStyleObject;
+  props?: T;
+}
+interface BadgePassThrough<RootElementAttributes = ElementAttributes> {
+  root?: BadgeSlotPassThrough<RootElementAttributes>;
+  label?: BadgeSlotPassThrough;
+  content?: BadgeSlotPassThrough;
+}
+interface BadgeBaseCommon<RootElementAttributes = ElementAttributes> {
+  size?: BadgeSize;
+  /** When false, disables automatic button sizing inside the badge. Defaults to true. */
+  buttonFit?: boolean;
+  /** When false, disables automatic SVG sizing inside the badge. Defaults to true. */
+  svgFit?: boolean;
+  passThrough?: BadgePassThrough<RootElementAttributes>;
+}
+/**
+ * Base badge props shared across all frameworks (Svelte, Astro).
+ * Each framework extends this with its own additions.
+ *
+ * Panel surface props (`background`, `border`, `translucent`) are only allowed when `feedback="neutral"`.
+ */
+type BadgeBaseProps<RootElementAttributes = ElementAttributes> = BadgeBaseCommon<RootElementAttributes> & ({
+  feedback: "neutral";
+  emphasis?: BadgeEmphasis;
+  background?: BadgeBackground;
+  border?: BadgeBorder;
+  translucent?: boolean;
+} | {
+  feedback?: Exclude<BadgeFeedback, "neutral">;
+  emphasis?: BadgeEmphasis;
+  background?: never;
+  border?: never;
+  translucent?: never;
+});
+/**
+ * Options for connectBadge. Framework components can spread their props
+ * directly into this function.
+ *
+ * This is intentionally flat (no discriminated union) — the feedback/background
+ * constraint is enforced at the component level, not inside connectBadge.
+ */
+type ConnectBadgeOptions = BadgeBaseCommon<object> & {
+  feedback?: BadgeFeedback;
+  emphasis?: BadgeEmphasis;
+  background?: BadgeBackground;
+  border?: BadgeBorder;
+  translucent?: boolean;
+  buttonFit?: boolean;
+  class?: unknown;
+};
+interface BadgeClasses {
+  label: string;
+  content: string;
+}
+interface BadgeRootProps {
+  class: string;
+  "data-component": "badge";
+  [key: string]: unknown;
+}
+interface BadgeApi {
+  rootProps: BadgeRootProps;
+  classes: BadgeClasses;
+}
+//#endregion
+export { BadgeApi, BadgeBackground, BadgeBaseCommon, BadgeBaseProps, BadgeBorder, BadgeClasses, BadgeEmphasis, BadgeFeedback, BadgePassThrough, BadgeRootProps, BadgeSize, BadgeSlotPassThrough, ConnectBadgeOptions, ElementAttributes };
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/types.ts"],"mappings":";;;;;KAMY,iBAAA,GAAoB,OAAA,CAAQ,MAAA;AAAA,KAI5B,aAAA,GAAgB,WAAA,CAAY,eAAA;AAAA,KAC5B,aAAA,GAAgB,WAAA,CAAY,eAAA;AAAA,KAC5B,SAAA,GAAY,WAAA,CAAY,eAAA;;KAExB,eAAA,GAAkB,WAAA,CAAY,eAAA;;KAE9B,WAAA,GAAc,WAAA,CAAY,eAAA;AAAA,UAIrB,oBAAA,KAAyB,iBAAA;EACxC,KAAA,GAAQ,iBAAA;EACR,KAAA,GAAQ,CAAA;AAAA;AAAA,UAGO,gBAAA,yBAAyC,iBAAA;EACxD,IAAA,GAAO,oBAAA,CAAqB,qBAAA;EAC5B,KAAA,GAAQ,oBAAA;EACR,OAAA,GAAU,oBAAA;AAAA;AAAA,UAKK,eAAA,yBAAwC,iBAAA;EACvD,IAAA,GAAO,SAAA;;EAEP,SAAA;EAxBiD;EA0BjD,MAAA;EACA,WAAA,GAAc,gBAAA,CAAiB,qBAAA;AAAA;;;AAvBjC;;;;KAgCY,cAAA,yBAAuC,iBAAA,IACjD,eAAA,CAAgB,qBAAA;EAGR,QAAA;EACA,QAAA,GAAW,aAAA;EACX,UAAA,GAAa,eAAA;EACb,MAAA,GAAS,WAAA;EACT,WAAA;AAAA;EAGA,QAAA,GAAW,OAAA,CAAQ,aAAA;EACnB,QAAA,GAAW,aAAA;EACX,UAAA;EACA,MAAA;EACA,WAAA;AAAA;;;;;AAtCV;;;KAmDY,mBAAA,GAAsB,eAAA;EAChC,QAAA,GAAW,aAAA;EACX,QAAA,GAAW,aAAA;EACX,UAAA,GAAa,eAAA;EACb,MAAA,GAAS,WAAA;EACT,WAAA;EACA,SAAA;EACA,KAAA;AAAA;AAAA,UAGe,YAAA;EACf,KAAA;EACA,OAAA;AAAA;AAAA,UAGe,cAAA;EACf,KAAA;EACA,gBAAA;EAAA,CACC,GAAA;AAAA;AAAA,UAGc,QAAA;EACf,SAAA,EAAW,cAAA;EACX,OAAA,EAAS,YAAA;AAAA"}

package/dist/src/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@pindoba/core-badge",
+  "version": "0.0.0-alpha-20260320034942",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/src/*.d.ts",
+      "import": "./dist/src/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@pindoba/core-panel": "0.0.0-alpha-20260320034942",
+    "@pindoba/styled-system": "0.0.0-alpha-20260320034942",
+    "@pindoba/styles-panel": "0.0.0-alpha-20260320034942",
+    "@pindoba/styles-badge": "0.0.0-alpha-20260320034942"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "tsdown": "^0.21.2"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "clean": "rm -rf dist && rm -rf node_modules && rm -rf .turbo"
+  }
+}