@musclemap/core 0.1.0

package/LICENSE

@@ -0,0 +1,34 @@
+MIT License
+
+Copyright (c) 2026 Jsplice / MuscleMap contributors
+
+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.
+
+---
+
+Scope of this license:
+
+- The MIT license above covers EVERYTHING in this repository — all source code,
+  the SVG muscle path data in `packages/assets` (original traced vector work),
+  and the body photographs in `apps/playground/public/` (`bg-male-*.png`,
+  `bg-female-*.png`).
+- The body photographs were generated with OpenAI image tooling (from the
+  maintainer's own prompts) and manually edited. They are released under MIT as
+  well — free to use, copy, modify, and redistribute. See ASSET_PROVENANCE.md
+  for details.

package/dist/color-scales.d.ts

@@ -0,0 +1,3 @@
+import type { MuscleColorModel } from "./types";
+export declare function getMuscleColor(score: number, model?: MuscleColorModel): string;
+//# sourceMappingURL=color-scales.d.ts.map

package/dist/color-scales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-scales.d.ts","sourceRoot":"","sources":["../src/color-scales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgDhD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,gBAAyB,GAAG,MAAM,CAOtF"}

package/dist/color-scales.js

@@ -0,0 +1,51 @@
+const NEUTRAL = "#334155";
+/**
+ * Stepped color scales per model, ordered high → low. The first stop whose
+ * `min` the (clamped) score reaches wins; the trailing `min: 0` stop is the
+ * model's base color. Data-driven so each model stays a flat table.
+ */
+const SCALE_STOPS = {
+    LOAD: [
+        { min: 86, color: "#ef4444" },
+        { min: 71, color: "#f97316" },
+        { min: 51, color: "#facc15" },
+        { min: 31, color: "#22c55e" },
+        { min: 11, color: "#0ea5e9" },
+        { min: 0, color: NEUTRAL },
+    ],
+    FREQUENCY: [
+        { min: 86, color: "#ef4444" },
+        { min: 61, color: "#f97316" },
+        { min: 31, color: "#22c55e" },
+        { min: 1, color: "#0ea5e9" },
+        { min: 0, color: NEUTRAL },
+    ],
+    BALANCE: [
+        { min: 81, color: "#ef4444" },
+        { min: 61, color: "#f97316" },
+        { min: 46, color: "#22c55e" },
+        { min: 31, color: "#38bdf8" },
+        { min: 0, color: "#8b5cf6" },
+    ],
+    RECOVERY_RISK: [
+        { min: 76, color: "#ef4444" },
+        { min: 51, color: "#f97316" },
+        { min: 26, color: "#facc15" },
+        { min: 0, color: "#22c55e" },
+    ],
+};
+function clampScore(score) {
+    if (!Number.isFinite(score))
+        return 0;
+    return Math.max(0, Math.min(100, score));
+}
+export function getMuscleColor(score, model = "LOAD") {
+    const value = clampScore(score);
+    const stops = SCALE_STOPS[model] ?? [];
+    for (const stop of stops) {
+        if (value >= stop.min)
+            return stop.color;
+    }
+    return NEUTRAL;
+}
+//# sourceMappingURL=color-scales.js.map

package/dist/color-scales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-scales.js","sourceRoot":"","sources":["../src/color-scales.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,SAAS,CAAC;AAK1B;;;;GAIG;AACH,MAAM,WAAW,GAAmD;IAClE,IAAI,EAAE;QACJ,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;KAC3B;IACD,SAAS,EAAE;QACT,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;QAC5B,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;KAC3B;IACD,OAAO,EAAE;QACP,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;KAC7B;IACD,aAAa,EAAE;QACb,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE;KAC7B;CACF,CAAC;AAEF,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,QAA0B,MAAM;IAC5E,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/heat-colors.d.ts

@@ -0,0 +1,20 @@
+import type { MuscleColorModel } from "./types";
+export type ColorStop = {
+    /** Position on the 0..1 scale. */
+    offset: number;
+    /** Hex color, e.g. "#22c55e". */
+    color: string;
+};
+/** Returns the gradient stops for a color model, useful for legends/defs. */
+export declare function getColorScaleStops(model?: MuscleColorModel): ColorStop[];
+/**
+ * Smoothly interpolated heatmap color for a 0..100 score.
+ *
+ * Unlike {@link getMuscleColor} (which returns discrete category buckets used
+ * for badges and labels), this produces the continuous fill color shown on the
+ * body, matching the premium heatmap look.
+ */
+export declare function getMuscleHeatColor(score: number, model?: MuscleColorModel): string;
+/** CSS `linear-gradient(...)` string for a model, for legend bars in any framework. */
+export declare function getColorScaleCss(model?: MuscleColorModel, angle?: string): string;
+//# sourceMappingURL=heat-colors.d.ts.map

package/dist/heat-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heat-colors.d.ts","sourceRoot":"","sources":["../src/heat-colors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG;IACtB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AA2EF,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,gBAAyB,GAAG,SAAS,EAAE,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,gBAAyB,GAAG,MAAM,CAmB1F;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,gBAAyB,EAAE,KAAK,SAAU,GAAG,MAAM,CAK1F"}

package/dist/heat-colors.js

@@ -0,0 +1,107 @@
+function clamp01(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+function clampScore(score) {
+    if (!Number.isFinite(score))
+        return 0;
+    return Math.max(0, Math.min(100, score));
+}
+/**
+ * Continuous color ramps, one per color model. These drive the smooth heatmap
+ * fills and the legend gradients so both always stay in sync.
+ *
+ * - LOAD / FREQUENCY: turbo-style blue -> cyan -> green -> yellow -> orange -> red.
+ * - BALANCE: under-represented (violet/blue) -> balanced (green) -> over (red).
+ * - RECOVERY_RISK: ready (green) -> risky (red).
+ */
+const SCALES = {
+    LOAD: [
+        { offset: 0.0, color: "#1e293b" },
+        { offset: 0.12, color: "#0ea5e9" },
+        { offset: 0.34, color: "#22d3ee" },
+        { offset: 0.52, color: "#22c55e" },
+        { offset: 0.68, color: "#facc15" },
+        { offset: 0.84, color: "#f97316" },
+        { offset: 1.0, color: "#ef4444" },
+    ],
+    FREQUENCY: [
+        { offset: 0.0, color: "#1e293b" },
+        { offset: 0.18, color: "#0ea5e9" },
+        { offset: 0.45, color: "#22c55e" },
+        { offset: 0.72, color: "#f97316" },
+        { offset: 1.0, color: "#ef4444" },
+    ],
+    BALANCE: [
+        { offset: 0.0, color: "#8b5cf6" },
+        { offset: 0.32, color: "#38bdf8" },
+        { offset: 0.52, color: "#22c55e" },
+        { offset: 0.74, color: "#f97316" },
+        { offset: 1.0, color: "#ef4444" },
+    ],
+    RECOVERY_RISK: [
+        { offset: 0.0, color: "#22c55e" },
+        { offset: 0.4, color: "#facc15" },
+        { offset: 0.7, color: "#f97316" },
+        { offset: 1.0, color: "#ef4444" },
+    ],
+};
+function hexToRgb(hex) {
+    const value = hex.replace("#", "");
+    const r = parseInt(value.slice(0, 2), 16);
+    const g = parseInt(value.slice(2, 4), 16);
+    const b = parseInt(value.slice(4, 6), 16);
+    return [r, g, b];
+}
+function toHex(channel) {
+    return Math.round(clamp01(channel / 255) * 255)
+        .toString(16)
+        .padStart(2, "0");
+}
+function mix(a, b, t) {
+    const [ar, ag, ab] = hexToRgb(a);
+    const [br, bg, bb] = hexToRgb(b);
+    const r = ar + (br - ar) * t;
+    const g = ag + (bg - ag) * t;
+    const bl = ab + (bb - ab) * t;
+    return `#${toHex(r)}${toHex(g)}${toHex(bl)}`;
+}
+/** Returns the gradient stops for a color model, useful for legends/defs. */
+export function getColorScaleStops(model = "LOAD") {
+    return SCALES[model] ?? SCALES.LOAD;
+}
+/**
+ * Smoothly interpolated heatmap color for a 0..100 score.
+ *
+ * Unlike {@link getMuscleColor} (which returns discrete category buckets used
+ * for badges and labels), this produces the continuous fill color shown on the
+ * body, matching the premium heatmap look.
+ */
+export function getMuscleHeatColor(score, model = "LOAD") {
+    const t = clampScore(score) / 100;
+    const stops = getColorScaleStops(model);
+    if (t <= stops[0].offset)
+        return stops[0].color;
+    const last = stops[stops.length - 1];
+    if (t >= last.offset)
+        return last.color;
+    for (let i = 0; i < stops.length - 1; i++) {
+        const current = stops[i];
+        const next = stops[i + 1];
+        if (t >= current.offset && t <= next.offset) {
+            const span = next.offset - current.offset || 1;
+            const local = (t - current.offset) / span;
+            return mix(current.color, next.color, local);
+        }
+    }
+    return last.color;
+}
+/** CSS `linear-gradient(...)` string for a model, for legend bars in any framework. */
+export function getColorScaleCss(model = "LOAD", angle = "90deg") {
+    const stops = getColorScaleStops(model)
+        .map((stop) => `${stop.color} ${Math.round(stop.offset * 100)}%`)
+        .join(", ");
+    return `linear-gradient(${angle}, ${stops})`;
+}
+//# sourceMappingURL=heat-colors.js.map

package/dist/heat-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heat-colors.js","sourceRoot":"","sources":["../src/heat-colors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./color-scales";
+export * from "./heat-colors";
+export * from "./muscle-meta";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./color-scales";
+export * from "./heat-colors";
+export * from "./muscle-meta";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/muscle-meta.d.ts

@@ -0,0 +1,36 @@
+import type { MuscleGroup, MuscleMapRegion, MuscleMapView } from "./types";
+/**
+ * Which body view(s) a muscle group is visible in.
+ * Some groups (side delts, forearms, calves) are visible from both sides.
+ */
+export type MuscleVisibility = "FRONT" | "BACK" | "BOTH";
+export type RegionTag = Exclude<MuscleMapRegion, "FULL_BODY">;
+export type MuscleGroupMeta = {
+    group: MuscleGroup;
+    /**
+     * Region buckets this group belongs to. A group can belong to several — e.g.
+     * the abs are part of both `UPPER_BODY` and `CORE` — so `UPPER_BODY` views
+     * include the core while a `CORE` view can still isolate it.
+     */
+    regions: RegionTag[];
+    /** Where the muscle is anatomically rendered. */
+    visibility: MuscleVisibility;
+    /** Whether the group is drawn as a left/right pair or a single centered path. */
+    bilateral: boolean;
+};
+/**
+ * Single source of truth for how every muscle group maps to regions and views.
+ * Headless data only — no UI, no copy. Host apps own localized labels.
+ */
+export declare const MUSCLE_GROUP_META: Record<MuscleGroup, MuscleGroupMeta>;
+export declare const ALL_MUSCLE_GROUPS: MuscleGroup[];
+/**
+ * Returns the muscle groups that should be rendered for a given view and region.
+ *
+ * - `view` decides which anatomical side is shown (FRONT / BACK / BOTH).
+ * - `region` narrows the set to upper body, lower body, or core.
+ *
+ * The result is stable-ordered following {@link ALL_MUSCLE_GROUPS}.
+ */
+export declare function getVisibleMuscleGroups(view: MuscleMapView, region?: MuscleMapRegion): MuscleGroup[];
+//# sourceMappingURL=muscle-meta.d.ts.map

package/dist/muscle-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"muscle-meta.d.ts","sourceRoot":"","sources":["../src/muscle-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,iDAAiD;IACjD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,eAAe,CAsBlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAAoD,CAAC;AAYhG;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,eAA6B,GACpC,WAAW,EAAE,CAKf"}

package/dist/muscle-meta.js

@@ -0,0 +1,53 @@
+/**
+ * Single source of truth for how every muscle group maps to regions and views.
+ * Headless data only — no UI, no copy. Host apps own localized labels.
+ */
+export const MUSCLE_GROUP_META = {
+    CHEST: { group: "CHEST", regions: ["UPPER_BODY"], visibility: "FRONT", bilateral: true },
+    BACK_UPPER: { group: "BACK_UPPER", regions: ["UPPER_BODY"], visibility: "BACK", bilateral: true },
+    BACK_LOWER: { group: "BACK_LOWER", regions: ["UPPER_BODY", "CORE"], visibility: "BACK", bilateral: true },
+    TRAPEZIUS: { group: "TRAPEZIUS", regions: ["UPPER_BODY"], visibility: "BOTH", bilateral: true },
+    RHOMBOIDS: { group: "RHOMBOIDS", regions: ["UPPER_BODY"], visibility: "BACK", bilateral: true },
+    LATS: { group: "LATS", regions: ["UPPER_BODY"], visibility: "BACK", bilateral: true },
+    SHOULDERS_FRONT: { group: "SHOULDERS_FRONT", regions: ["UPPER_BODY"], visibility: "FRONT", bilateral: true },
+    SHOULDERS_SIDE: { group: "SHOULDERS_SIDE", regions: ["UPPER_BODY"], visibility: "BOTH", bilateral: true },
+    SHOULDERS_REAR: { group: "SHOULDERS_REAR", regions: ["UPPER_BODY"], visibility: "BACK", bilateral: true },
+    BICEPS: { group: "BICEPS", regions: ["UPPER_BODY"], visibility: "FRONT", bilateral: true },
+    TRICEPS: { group: "TRICEPS", regions: ["UPPER_BODY"], visibility: "BACK", bilateral: true },
+    FOREARMS: { group: "FOREARMS", regions: ["UPPER_BODY"], visibility: "BOTH", bilateral: true },
+    CORE: { group: "CORE", regions: ["UPPER_BODY", "CORE"], visibility: "FRONT", bilateral: false },
+    OBLIQUES: { group: "OBLIQUES", regions: ["UPPER_BODY", "CORE"], visibility: "BOTH", bilateral: true },
+    GLUTES: { group: "GLUTES", regions: ["LOWER_BODY"], visibility: "BACK", bilateral: true },
+    QUADS: { group: "QUADS", regions: ["LOWER_BODY"], visibility: "FRONT", bilateral: true },
+    HAMSTRINGS: { group: "HAMSTRINGS", regions: ["LOWER_BODY"], visibility: "BACK", bilateral: true },
+    CALVES: { group: "CALVES", regions: ["LOWER_BODY"], visibility: "BOTH", bilateral: true },
+    HIP_FLEXORS: { group: "HIP_FLEXORS", regions: ["LOWER_BODY"], visibility: "FRONT", bilateral: true },
+    ADDUCTORS: { group: "ADDUCTORS", regions: ["LOWER_BODY"], visibility: "BOTH", bilateral: true },
+    ABDUCTORS: { group: "ABDUCTORS", regions: ["LOWER_BODY"], visibility: "BOTH", bilateral: true },
+};
+export const ALL_MUSCLE_GROUPS = Object.keys(MUSCLE_GROUP_META);
+function matchesView(visibility, view) {
+    if (view === "BOTH")
+        return true;
+    if (visibility === "BOTH")
+        return true;
+    return visibility === view;
+}
+function matchesRegion(regions, filter) {
+    return filter === "FULL_BODY" || regions.includes(filter);
+}
+/**
+ * Returns the muscle groups that should be rendered for a given view and region.
+ *
+ * - `view` decides which anatomical side is shown (FRONT / BACK / BOTH).
+ * - `region` narrows the set to upper body, lower body, or core.
+ *
+ * The result is stable-ordered following {@link ALL_MUSCLE_GROUPS}.
+ */
+export function getVisibleMuscleGroups(view, region = "FULL_BODY") {
+    return ALL_MUSCLE_GROUPS.filter((group) => {
+        const meta = MUSCLE_GROUP_META[group];
+        return matchesView(meta.visibility, view) && matchesRegion(meta.regions, region);
+    });
+}
+//# sourceMappingURL=muscle-meta.js.map

package/dist/muscle-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muscle-meta.js","sourceRoot":"","sources":["../src/muscle-meta.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export type MuscleGroup = "CHEST" | "BACK_UPPER" | "BACK_LOWER" | "TRAPEZIUS" | "RHOMBOIDS" | "LATS" | "SHOULDERS_FRONT" | "SHOULDERS_SIDE" | "SHOULDERS_REAR" | "BICEPS" | "TRICEPS" | "FOREARMS" | "CORE" | "OBLIQUES" | "GLUTES" | "QUADS" | "HAMSTRINGS" | "CALVES" | "HIP_FLEXORS" | "ADDUCTORS" | "ABDUCTORS";
+export type MuscleMapSex = "MALE" | "FEMALE";
+export type MuscleMapView = "FRONT" | "BACK" | "BOTH";
+export type MuscleMapRegion = "FULL_BODY" | "UPPER_BODY" | "LOWER_BODY" | "CORE";
+export type MuscleMapMode = "OVERALL" | "STRENGTH" | "CARDIO" | "MOBILITY";
+export type MuscleColorModel = "LOAD" | "FREQUENCY" | "BALANCE" | "RECOVERY_RISK";
+export type MuscleTrend = "UP" | "DOWN" | "STABLE";
+export type MuscleMapValue = {
+    score: number;
+    volumeKg?: number;
+    sets?: number;
+    sessions?: number;
+    trend?: MuscleTrend;
+};
+export type MuscleMapValues = Partial<Record<MuscleGroup, MuscleMapValue>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,WAAW,GACX,MAAM,GACN,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,GACN,UAAU,GACV,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAC7C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;AACjF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC3E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,eAAe,CAAC;AAClF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@musclemap/core",
+  "version": "0.1.0",
+  "description": "Headless core for MuscleMap — muscle-group types, color scales and region/visibility rules. UI-free.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "musclemap",
+    "muscle",
+    "anatomy",
+    "heatmap",
+    "fitness",
+    "headless"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Jsplice/MuscleMap.git",
+    "directory": "packages/core"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --root ../.. packages/core"
+  }
+}