@frigear-nu/ui 0.0.9 → 0.1.0

package/dist/runtime/utils/index.js

@@ -0,0 +1,6 @@
+export * from "./errors.js";
+export * from "./format.js";
+export * from "./locale.js";
+export * from "./status.js";
+export * from "./surface.js";
+export * from "./table.js";

package/dist/runtime/utils/locale.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Removes a leading `/<locale>` segment (one of `codes`), the query, the hash and a trailing slash from a path, so
+ * paths compare the same with and without an `@nuxtjs/i18n` prefix: `stripLocale('/da/admin/', ['en', 'da'])` is
+ * `/admin`.
+ */
+export declare function stripLocale(path: string, codes: readonly string[]): string;
+/** Whether `to` points outside the app (`https://…`, `mailto:…`, protocol-relative `//…`). */
+export declare function isExternalPath(to: string): boolean;

package/dist/runtime/utils/locale.js

@@ -0,0 +1,10 @@
+export function stripLocale(path, codes) {
+  const pathname = path.split(/[?#]/)[0] || "/";
+  const trimmed = pathname.length > 1 ? pathname.replace(/\/+$/, "") || "/" : pathname;
+  const first = trimmed.split("/")[1];
+  if (!first || !codes.includes(first)) return trimmed;
+  return trimmed.slice(first.length + 1) || "/";
+}
+export function isExternalPath(to) {
+  return /^(?:[a-z][a-z\d+.-]*:|\/\/)/i.test(to);
+}

package/dist/runtime/utils/status.d.ts

@@ -0,0 +1,7 @@
+import type { StatusColor } from '../types.js';
+/**
+ * The badge colour of a status: green for done or live states (published, active, trialing, paid, succeeded), amber
+ * for states that need attention (pending, past_due, incomplete, scheduled), red for failed, neutral otherwise.
+ * `overrides` (keyed by lower-case status) win.
+ */
+export declare function statusColor(status: string | null | undefined, overrides?: Record<string, StatusColor>): StatusColor;

package/dist/runtime/utils/status.js

@@ -0,0 +1,17 @@
+const DEFAULT_STATUS_COLORS = {
+  published: "success",
+  active: "success",
+  trialing: "success",
+  paid: "success",
+  succeeded: "success",
+  pending: "warning",
+  past_due: "warning",
+  incomplete: "warning",
+  scheduled: "warning",
+  failed: "error"
+};
+export function statusColor(status, overrides = {}) {
+  if (!status) return "neutral";
+  const key = status.toLowerCase();
+  return overrides[key] ?? DEFAULT_STATUS_COLORS[key] ?? "neutral";
+}

package/dist/runtime/utils/surface.d.ts

@@ -0,0 +1,22 @@
+/** The surface every card shares (`SectionCard`, `TableCard`, `StatCard`, `ListCard`). */
+export declare const surfaceClass = "bg-elevated/50 ring ring-default rounded-lg overflow-hidden";
+export interface TableUi {
+    root?: string;
+    th?: string;
+    td?: string;
+    tr?: string;
+    [slot: string]: string | undefined;
+}
+export interface TableUiOptions {
+    /**
+     * For a `UTable sticky`: the table scrolls inside its card (`max-h-[70vh]`) so the header stays in view. Nuxt UI
+     * gives the sticky header its own translucent background.
+     */
+    sticky?: boolean;
+}
+/**
+ * The `:ui` of a `UTable` inside a `TableCard`: small muted headers, compact rows on desktop and taller (touch
+ * friendly) rows on mobile, clickable rows. `overrides` replace single slots (`tableUi({ tr: '' })` for rows that do
+ * not open anything).
+ */
+export declare function tableUi(overrides?: TableUi, options?: TableUiOptions): TableUi;

package/dist/runtime/utils/surface.js

@@ -0,0 +1,10 @@
+export const surfaceClass = "bg-elevated/50 ring ring-default rounded-lg overflow-hidden";
+export function tableUi(overrides = {}, options = {}) {
+  return {
+    ...options.sticky ? { root: "max-h-[70vh]" } : {},
+    th: "text-muted text-xs font-normal py-2",
+    td: "max-md:py-3 md:py-2",
+    tr: "cursor-pointer",
+    ...overrides
+  };
+}

package/dist/runtime/utils/table.d.ts

@@ -0,0 +1,28 @@
+/** One sorted column in `UTable`'s shape. */
+export interface TableSortState {
+    id: string;
+    desc: boolean;
+}
+/** The meta of a column holding numbers: right-aligned, tabular figures so digits line up. */
+export declare const numericColumn: {
+    readonly class: {
+        readonly th: "text-right";
+        readonly td: "text-right tabular-nums";
+    };
+};
+/** A dimmed dash for a cell without a value (no date, no role, ...). */
+export declare function emptyCell(): import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>;
+/** The sort after a click on `id`'s header: ascending, then descending, then unsorted. */
+export declare function nextTableSort(current: TableSortState | null | undefined, id: string): TableSortState | null;
+/** The `sort` / `order` query of a server-sorted list (both `undefined` when unsorted). */
+export declare function tableSortQuery(sort: TableSortState | null | undefined): {
+    sort?: string;
+    order?: 'asc' | 'desc';
+};
+/** The first and last row number shown on `page` (1-based), `{ from: 0, to: 0 }` when it is empty. */
+export declare function tablePageRange(page: number, pageSize: number, total: number): {
+    from: number;
+    to: number;
+};

package/dist/runtime/utils/table.js

@@ -0,0 +1,17 @@
+import { h } from "vue";
+export const numericColumn = { class: { th: "text-right", td: "text-right tabular-nums" } };
+export function emptyCell() {
+  return h("span", { class: "text-dimmed" }, "\u2014");
+}
+export function nextTableSort(current, id) {
+  if (current?.id !== id) return { id, desc: false };
+  return current.desc ? null : { id, desc: true };
+}
+export function tableSortQuery(sort) {
+  return sort ? { sort: sort.id, order: sort.desc ? "desc" : "asc" } : { sort: void 0, order: void 0 };
+}
+export function tablePageRange(page, pageSize, total) {
+  const from = (page - 1) * pageSize + 1;
+  if (total <= 0 || from > total) return { from: 0, to: 0 };
+  return { from, to: Math.min(page * pageSize, total) };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frigear-nu/ui",
-  "version": "0.0.9",
+  "version": "0.1.0",
   "description": "Shared UI components and composables for Frigear Nuxt applications, built on Nuxt UI.",
   "license": "MIT",
   "homepage": "https://docs.frigear.dev/modules/ui",
@@ -22,7 +22,9 @@
     "./composables/*": "./dist/runtime/composables/*.js",
     "./translated": "./dist/runtime/translated.js",
     "./markdown": "./dist/runtime/markdown.js",
-    "./money": "./dist/runtime/shared/money.js"
+    "./money": "./dist/runtime/shared/money.js",
+    "./utils": "./dist/runtime/utils/index.js",
+    "./types": "./dist/runtime/types.js"
   },
   "main": "./dist/module.mjs",
   "workspaces": [
@@ -32,28 +34,40 @@
     "dist"
   ],
   "dependencies": {
-    "@nuxt/kit": "^4.6.0",
+    "@frigear-nu/module-kit": "1.1.0",
+    "@nuxt/kit": "^4.6.1",
     "@vueuse/core": "^13.5.0",
-    "defu": "^6.1.4",
-    "nuxt-monaco-editor": "^1.4.1",
-    "monaco-editor": "^0.56.0"
+    "defu": "^6.1.4"
   },
   "devDependencies": {
-    "@frigear-nu/eslint-config": "0.0.4",
+    "@frigear-nu/eslint-config": "0.1.0",
     "@nuxt/module-builder": "^1.0.3",
-    "@nuxt/schema": "^4.6.0",
-    "@nuxt/ui": "^4.10.0",
-    "eslint": "^10.8.1",
+    "@nuxt/schema": "^4.6.1",
+    "@nuxt/test-utils": "^4.3.2",
+    "@nuxt/ui": "^4.11.2",
+    "eslint": "^10.12.0",
+    "monaco-editor": "^0.56.0",
     "nuxt": "^4.6.1",
+    "nuxt-monaco-editor": "^1.4.1",
     "tailwindcss": "^4.3.3",
     "typescript": "^6.0.3",
-    "vitest": "^5.0.0",
+    "vitest": "^5.0.2",
     "vue-tsc": "^3.3.11"
   },
   "peerDependencies": {
-    "@nuxt/ui": "^4.10.0",
-    "nuxt": "^3.0.0 || ^4.0.0",
-    "vue": "3.x"
+    "@nuxt/ui": "^4.11.2",
+    "nuxt": "^4.6.1",
+    "vue": "3.x",
+    "monaco-editor": "^0.56.0",
+    "nuxt-monaco-editor": "^1.4.1"
+  },
+  "peerDependenciesMeta": {
+    "monaco-editor": {
+      "optional": true
+    },
+    "nuxt-monaco-editor": {
+      "optional": true
+    }
   },
   "scripts": {
     "postinstall": "nuxt-module-build build --stub && nuxt prepare",

package/dist/runtime/components/App/AppPageHeader.d.vue.ts

@@ -1,23 +0,0 @@
-import type { ButtonProps, PageHeaderProps, BreadcrumbItem } from '@nuxt/ui';
-type Props = PageHeaderProps & {
-    returnButton?: ButtonProps | false;
-    crumbs?: BreadcrumbItem[];
-};
-declare var __VLS_9: {}, __VLS_28: string, __VLS_29: {};
-type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_28>]?: (props: typeof __VLS_29) => any;
-} & {
-    headline?: (props: typeof __VLS_9) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
-    returnButton: ButtonProps | false;
-    crumbs: BreadcrumbItem[];
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/dist/runtime/components/App/AppPageHeader.vue

@@ -1,58 +0,0 @@
-<script setup>
-import { objectOmit } from "@vueuse/core";
-import defu from "defu";
-defineProps({
-  as: { type: null, required: false },
-  headline: { type: String, required: false },
-  title: { type: String, required: false },
-  description: { type: String, required: false },
-  links: { type: Array, required: false },
-  class: { type: null, required: false },
-  ui: { type: Object, required: false },
-  returnButton: { type: [Object, Boolean], required: false, default: () => ({
-    label: "Dashboard",
-    to: "/app",
-    icon: "i-lucide-arrow-left",
-    variant: "link"
-  }) },
-  crumbs: { type: Array, required: false, default: () => [] }
-});
-const forwardedSlots = ["links", "description"];
-</script>
-
-<template>
-  <UPageHeader
-    v-bind="objectOmit($props, ['returnButton'])"
-    :ui="{ headline: 'flex-1 p-0' }"
-  >
-    <!-- Manually handled slot -->
-    <template #headline>
-      <slot name="headline">
-        <div class="flex items-center gap-2">
-          <UButton
-            v-if="returnButton !== false && returnButton !== void 0"
-            class="p-0"
-            v-bind="defu(returnButton, { variant: 'link' })"
-          />
-          <UIcon
-            v-if="crumbs && crumbs.length > 0"
-            name="i-lucide-chevron-right"
-          />
-          <UBreadcrumb
-            v-if="crumbs && crumbs.length > 0"
-            :items="crumbs"
-            label-key="label"
-          />
-        </div>
-      </slot>
-    </template>
-
-    <template
-      v-for="slotName in forwardedSlots"
-      :key="slotName"
-      #[slotName]
-    >
-      <slot :name="slotName" />
-    </template>
-  </UPageHeader>
-</template>

package/dist/runtime/components/App/AppPageHeader.vue.d.ts

@@ -1,23 +0,0 @@
-import type { ButtonProps, PageHeaderProps, BreadcrumbItem } from '@nuxt/ui';
-type Props = PageHeaderProps & {
-    returnButton?: ButtonProps | false;
-    crumbs?: BreadcrumbItem[];
-};
-declare var __VLS_9: {}, __VLS_28: string, __VLS_29: {};
-type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_28>]?: (props: typeof __VLS_29) => any;
-} & {
-    headline?: (props: typeof __VLS_9) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
-    returnButton: ButtonProps | false;
-    crumbs: BreadcrumbItem[];
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-export default _default;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};