@sincpro/web-ui 0.0.0-stage → 0.2.0

package/dist/foundations/copy.js

@@ -0,0 +1,520 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+export const ENGLISH_COPY = {
+    locale: "en-US",
+    present: {
+        rows: "Rows",
+        table: "Table",
+        board: "Board",
+        sheet: "Sheet",
+        report: "Report",
+        pivot: "Pivot",
+        chart: "Chart",
+        group: "How to view",
+    },
+    frame: {
+        columns: "columns",
+        show: "show",
+        series: "series",
+        column: "column",
+        empty: "No cells to show.",
+        noSeries: "This column has no values to chart.",
+        required: "always shown",
+        optional: "optional",
+    },
+    selection: {
+        chosen: "chosen",
+        clear: "Clear selection",
+        all: "Select all",
+        row: "Select row",
+        named: "Select {name}",
+        more: "More actions",
+        moreOf: "More actions for {name}",
+    },
+    pager: {
+        size: "Rows per page",
+        sizeHint: "{size} per page — click to change",
+        prev: "Previous page",
+        next: "Next page",
+    },
+    record: {
+        prev: "Previous record",
+        next: "Next record",
+        location: "Location",
+        status: "Status",
+        faces: "Record faces",
+        unsaved: "unsaved",
+        save: "Save",
+        saving: "Saving…",
+        discard: "Discard",
+        failed: "failed",
+        notices: "Notices about this record",
+        noticeOne: "{count} notice",
+        noticeMany: "{count} notices",
+        blocking: "What is wrong with this record",
+    },
+    shell: {
+        modules: "All modules",
+        menus: "Module menus",
+        close: "Close",
+        notices: "Notices",
+        closeNotice: "Dismiss notice",
+        preview: "Preview",
+        previewTag: "preview",
+        closePreview: "Close preview",
+        account: "My account",
+        openAsPanel: "Open as panel",
+        commandPalette: "Command palette",
+    },
+    field: {
+        drop: "Drop a file here, or choose one.",
+        chooseFile: "Choose file",
+        cancel: "Cancel",
+        uploadProgress: "upload progress",
+        fileUnreadable: "We could not read the file",
+        tryAnother: "Try another one",
+        required: "required",
+        help: "Help",
+        unset: "not set",
+        none: "None",
+    },
+    choice: {
+        noResults: "No results",
+        search: "Search",
+    },
+    search: {
+        tools: "Filter, group and favorites",
+        editChip: "Click to edit",
+        editNamed: "Edit {label}",
+        removeChip: "Remove {label}: {value}",
+        removeFilter: "Remove filter {label}",
+        removeGroup: "Stop grouping by {label}",
+        and: "and",
+        or: "or",
+        groupedBy: "grouped by",
+        narrowedBy: "showing",
+        switchJoin: "All of them, or any of them",
+        joins: { all: "all", any: "any", none: "none" },
+        notWord: "not",
+        landsHere: "the next one lands here",
+        closeGroup: "Close this group",
+        typeValue: "value…",
+        dropField: "Ask about another field",
+        dropOp: "Compare another way",
+        openBuilder: "Open all of this in the builder",
+        openBuilderHere: "Open this condition in the builder",
+        askField: "ask about",
+        askAttribute: "pick an attribute",
+        askOp: "compared how",
+        askJoin: "these rules match",
+        unreadable: "We cannot read this filter as a tree — here it is as it stands. It can still be edited as JSON below.",
+        askValue: "to what",
+        condition: "{field} {op} {value}",
+        andMore: "and {count} more",
+        placeholder: "search…",
+        filters: "filters",
+        groupBy: "group by",
+        favorites: "favorites",
+    },
+    failed: {
+        operation: "We could not complete the operation",
+        list: "We could not read the list",
+        loading: "Loading…",
+        retry: "Try again",
+    },
+    table: {
+        add: "Add",
+        row: "row",
+        rows: "rows",
+        yes: "yes",
+        no: "no",
+        mean: "mean {value}",
+        min: "min {value}",
+        max: "max {value}",
+        distinct: "{value} distinct",
+    },
+    menu: {
+        empty: "Nothing matches.",
+    },
+    list: {
+        empty: "There is nothing here yet.",
+        emptyFiltered: "Nothing matches what is on.",
+        countOne: "1 record",
+        count: "{count} records",
+    },
+    activity: {
+        bySystem: "the system",
+        more: "show the whole error",
+        less: "show less",
+        internal: "internal",
+        internalNote: "Internal note: it stays in here",
+        writeNote: "Log a note",
+        notePlaceholder: "A note that stays in here…",
+        recipients: "Who receives it",
+        noRecipients: "nobody to send it to yet",
+        messagePlaceholder: "Write a message…",
+        emptyMessages: "Nobody has written here yet.",
+        emptyEvents: "Nothing has been logged yet.",
+        title: "Activity",
+        open: "Open the {label}",
+        fold: "Fold the {label}",
+        alerts: "Notices",
+        conversation: "Conversation",
+        history: "History",
+        viewTimeline: "Timeline",
+        moreAlerts: "Show {count} more",
+        fewerAlerts: "Show fewer",
+        filters: "Show",
+        filterAll: "All",
+        filterConversation: "Messages",
+        filterNotes: "Notes",
+        filterEvents: "Events",
+        today: "Today",
+        yesterday: "Yesterday",
+        emptyFilter: "Nothing of this kind yet.",
+        goTo: "Go to {owner}",
+        send: "Send",
+        sending: "Sending…",
+        cancel: "Cancel",
+    },
+    copyable: {
+        label: "Copy",
+        done: "Copied",
+        failed: "Could not copy",
+        field: "Copy «{label}»",
+        empty: "Nothing to copy",
+    },
+    sorting: {
+        label: "Sort",
+        by: "sort by",
+        asc: "ascending",
+        desc: "descending",
+        clear: "no order",
+    },
+    dates: {
+        last: "last {count} {unit}",
+        prior: "previous {unit}",
+        day: "day",
+        days: "days",
+        week: "week",
+        weeks: "weeks",
+        month: "month",
+        months: "months",
+        quarter: "quarter",
+        quarters: "quarters",
+        year: "year",
+        years: "years",
+    },
+    ops: {
+        "=": "is",
+        "!=": "is not",
+        like: "contains",
+        in: "is one of",
+        "not in": "is none of",
+        ">": "greater than",
+        ">=": "at least",
+        "<": "less than",
+        "<=": "at most",
+        "is null": "is empty",
+        "is not null": "is not empty",
+        contains: "includes",
+        "not contains": "does not include",
+        between: "is between",
+    },
+    calendar: {
+        week: "Week {n}",
+        weekOfYear: "Week {n}, {year}",
+        quarter: "Q{n}",
+        quarterOfYear: "Q{n} {year}",
+    },
+    grouping: {
+        label: "Group by",
+        none: "Not grouped.",
+        add: "add a level",
+        remove: "remove this level",
+        up: "one level out",
+        down: "one level in",
+        clear: "stop grouping",
+        grain: "how finely",
+    },
+    editable: {
+        add: "Add a line",
+        addRow: "Add a row",
+        empty: "No lines yet.",
+        remove: "Remove the line",
+    },
+    picker: {
+        placeholder: "pick one…",
+        empty: "Nothing matches.",
+        search: "filter…",
+        loading: "loading…",
+        more: "{count} more",
+        refine: "— narrow the filter",
+        open: "Open",
+        browseAll: "see all…",
+        loadingMore: "loading more…",
+    },
+    cell: {
+        missing: "missing",
+        empty: "(empty)",
+        emptyBin: "(empty)",
+    },
+    time: {
+        justNow: "just now",
+        invalid: "invalid date",
+        noDate: "no date",
+    },
+    drill: {
+        back: "Back to {name}",
+        trail: "Opened from",
+    },
+    dialog: {
+        expand: "Expand to a panel",
+        cancel: "Cancel",
+        back: "Back",
+        next: "Next",
+        finish: "Finish",
+        busy: "Working…",
+    },
+    report: {
+        open: "Open {name}",
+        close: "Close {name}",
+        concept: "Item",
+    },
+    builder: {
+        filter: "Filter",
+        order: "Order",
+        groupBy: "Group by",
+        totals: "Totals per pile",
+        filterPiles: "Filter the piles",
+        pileOrder: "Pile order",
+        pilePage: "Pile page",
+        fields: "Fields",
+        noOrder: "No order of its own: the model's.",
+        noGrouping: "Not grouped: the whole list.",
+        noTotals: "No totals: just how many rows there are.",
+        noPileOrder: "No order of its own: by each level's field, ascending.",
+        allFields: "All of the model's.",
+        someFields: "{shown} of {total} — the identity always travels.",
+        addOrder: "order by…",
+        addGroup: "group by…",
+        addPileOrder: "Order the piles by another field",
+        ascending: "ascending",
+        descending: "descending",
+        flip: "tap to flip",
+        changeGrain: "tap to change the cut",
+        dropOrder: "remove this sort",
+        dropTotal: "remove this total",
+        dropRule: "remove this rule",
+        dropGroup: "remove this group",
+        addRule: "add a rule after this one",
+        addNested: "add a nested group after this one",
+        pilesNote: "Over what they folded — the totals above, and «count» — not over the rows: that is the filter above.",
+        pilePageNote: "Only the first level: once a page is asked for, the deeper levels answer only for the piles that survived.",
+        limitPiles: "Limit how many piles come back",
+        noValue: "no value",
+        from: "from…",
+        to: "to…",
+        value: "value…",
+        json: "The criteria, as JSON",
+        jsonFilter: "The filter, as JSON",
+        invalidJson: "this is not valid JSON",
+        editor: "Code editor",
+        format: "Format",
+        notCriteria: "a criteria is an object with where, order, grouping or specification",
+        notFilter: "this is not a filter: it needs a condition or an all/any/negate",
+        apply: "Apply",
+        add: "Add",
+        cancel: "Cancel",
+        totalAs: "as «{name}»",
+        addTotal: "Add a total",
+        dropOrderBy: "remove the order by {field}",
+        dropLevel: "remove the level {field}",
+    },
+    pivot: {
+        total: "Total",
+        rows: "rows",
+        open: "Open {row} × {column}",
+    },
+    person: {
+        unassigned: "unassigned",
+        contact: "Contact",
+        email: "Write an email",
+        call: "Call",
+        whatsapp: "WhatsApp",
+        open: "Open profile",
+    },
+    lines: {
+        add: "Add a line",
+        search: "Search the lines…",
+        edit: "Edit line",
+        remove: "Remove line",
+        empty: "No lines yet.",
+        done: "Done",
+        addSection: "Add a section",
+        addNote: "Add a note",
+        section: "Section",
+        note: "Note",
+    },
+    lineItems: {
+        one: "{count} line",
+        many: "{count} lines",
+        shown: "{shown} of {count} lines",
+        newLine: "New line",
+        noMatch: "No line matches «{query}».",
+        removed: "Removed «{name}».",
+        undo: "Undo",
+        table: "Lines",
+    },
+    relation: {
+        open: "Open",
+        none: "Not set",
+    },
+    relationCard: {
+        summary: "Summary of {name}",
+    },
+    totals: {
+        less: "less",
+        details: "Details: {label}",
+        open: "Open",
+        unlink: "Unlink",
+        credits: "Outstanding credits",
+        apply: "Apply",
+        applyCredit: "Apply {label}",
+    },
+    inlineEdit: {
+        addTag: "Add…",
+        createTag: "Create «{name}»",
+        editCell: "Edit {column}",
+    },
+    theme: {
+        label: "Theme",
+        system: "System",
+        light: "Light",
+        dark: "Dark",
+    },
+    tree: {
+        empty: "Nothing here yet.",
+    },
+    assist: {
+        assistant: "Assistant",
+        suggests: "suggests",
+        suggestion: "Assistant's suggestion",
+        source: "Source",
+        accept: "Accept",
+        dismiss: "Dismiss the suggestion",
+        accepted: "Applied the assistant's suggestion.",
+        acceptedIn: "Applied the assistant's suggestion to «{field}».",
+        undo: "Undo",
+        working: "The assistant is working…",
+        cancel: "Cancel",
+        madeBy: "Set by the assistant",
+        acceptedBy: "Accepted by {name}",
+        review: "Proposed changes",
+        applyOne: "Apply 1 change",
+        applyMany: "Apply {count} changes",
+        discard: "Discard",
+        all: "All the changes",
+        chosen: "{count} of {total} chosen",
+        noneChosen: "Choose at least one change.",
+        appliedOne: "Applied 1 change from the assistant.",
+        appliedMany: "Applied {count} changes from the assistant.",
+        added: "new",
+        removed: "removed",
+        changed: "changes",
+        from: "from",
+        to: "to",
+        empty: "empty",
+    },
+};
+let activeCopy = ENGLISH_COPY;
+/** The merged catalog the formatters read when they are not a component. */
+export function currentCopy() {
+    return activeCopy;
+}
+/** BCP-47 the formatters read when they are not a component. */
+export function currentCopyLocale() {
+    return activeCopy.locale;
+}
+function rememberCopy(copy) {
+    activeCopy = copy;
+}
+/**
+ * La copia del árbol, cuando alguien la puso.
+ *
+ * Arranca en `null` y NO en el inglés de fábrica: un contexto se queda con el
+ * valor que tenía cuando se creó, así que con el inglés adentro un componente
+ * sin provider ignoraba `installCopy` y seguía diciendo «grouped by» aunque la
+ * aplicación entera estuviera en castellano. Dos verdades sobre la misma cosa.
+ *
+ * Con `null`, sin provider se lee la instalada, que es la única.
+ */
+const CopyContext = createContext(null);
+export function mergeCopy(over) {
+    if (over === undefined)
+        return ENGLISH_COPY;
+    return {
+        locale: over.locale ?? ENGLISH_COPY.locale,
+        present: { ...ENGLISH_COPY.present, ...over.present },
+        frame: { ...ENGLISH_COPY.frame, ...over.frame },
+        selection: { ...ENGLISH_COPY.selection, ...over.selection },
+        pager: { ...ENGLISH_COPY.pager, ...over.pager },
+        record: { ...ENGLISH_COPY.record, ...over.record },
+        shell: { ...ENGLISH_COPY.shell, ...over.shell },
+        field: { ...ENGLISH_COPY.field, ...over.field },
+        choice: { ...ENGLISH_COPY.choice, ...over.choice },
+        search: { ...ENGLISH_COPY.search, ...over.search },
+        failed: { ...ENGLISH_COPY.failed, ...over.failed },
+        table: { ...ENGLISH_COPY.table, ...over.table },
+        menu: { ...ENGLISH_COPY.menu, ...over.menu },
+        list: { ...ENGLISH_COPY.list, ...over.list },
+        grouping: { ...ENGLISH_COPY.grouping, ...over.grouping },
+        dates: { ...ENGLISH_COPY.dates, ...over.dates },
+        calendar: { ...ENGLISH_COPY.calendar, ...over.calendar },
+        ops: { ...ENGLISH_COPY.ops, ...over.ops },
+        sorting: { ...ENGLISH_COPY.sorting, ...over.sorting },
+        copyable: { ...ENGLISH_COPY.copyable, ...over.copyable },
+        activity: { ...ENGLISH_COPY.activity, ...over.activity },
+        editable: { ...ENGLISH_COPY.editable, ...over.editable },
+        picker: { ...ENGLISH_COPY.picker, ...over.picker },
+        cell: { ...ENGLISH_COPY.cell, ...over.cell },
+        time: { ...ENGLISH_COPY.time, ...over.time },
+        drill: { ...ENGLISH_COPY.drill, ...over.drill },
+        dialog: { ...ENGLISH_COPY.dialog, ...over.dialog },
+        report: { ...ENGLISH_COPY.report, ...over.report },
+        builder: { ...ENGLISH_COPY.builder, ...over.builder },
+        pivot: { ...ENGLISH_COPY.pivot, ...over.pivot },
+        person: { ...ENGLISH_COPY.person, ...over.person },
+        lines: { ...ENGLISH_COPY.lines, ...over.lines },
+        lineItems: { ...ENGLISH_COPY.lineItems, ...over.lineItems },
+        relation: { ...ENGLISH_COPY.relation, ...over.relation },
+        relationCard: { ...ENGLISH_COPY.relationCard, ...over.relationCard },
+        totals: { ...ENGLISH_COPY.totals, ...over.totals },
+        inlineEdit: { ...ENGLISH_COPY.inlineEdit, ...over.inlineEdit },
+        theme: { ...ENGLISH_COPY.theme, ...over.theme },
+        tree: { ...ENGLISH_COPY.tree, ...over.tree },
+        assist: { ...ENGLISH_COPY.assist, ...over.assist },
+    };
+}
+/** For tests and non-React callers that need a locale before a provider mounts. */
+export function installCopy(over) {
+    const merged = mergeCopy(over);
+    rememberCopy(merged);
+    return merged;
+}
+export function UiCopyProvider({ copy, children, }) {
+    const merged = mergeCopy(copy);
+    rememberCopy(merged);
+    return _jsx(CopyContext.Provider, { value: merged, children: children });
+}
+export function useUiCopy() {
+    return useContext(CopyContext) ?? currentCopy();
+}
+/** `{name}` → value. A missing key stays visible in the template. */
+export function fillCopy(template, params) {
+    return template.replace(/\{(\w+)\}/g, (whole, name) => {
+        const value = params[name];
+        return value === undefined ? whole : String(value);
+    });
+}

package/dist/foundations/density.d.ts

@@ -0,0 +1,16 @@
+import { type ReactNode } from "react";
+export type Density = "comfortable" | "compact";
+/** The surface declares it: `Peek` and the narrow dialogs set it to `compact`;
+ *  a panel leaves it at `comfortable`. */
+export declare function DensityProvider({ value, children, }: {
+    value: Density;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useDensity(): Density;
+/** Pick between two values according to the density, without writing the
+ *  ternary.
+ *
+ *  It exists so the difference between the two stays on ONE readable line next
+ *  to the class, and not scattered across conditionals — which is how one of
+ *  the two densities ends up unmaintained. */
+export declare function byDensity<T>(d: Density, comfortable: T, compact: T): T;

package/dist/foundations/density.js

@@ -0,0 +1,21 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const Ctx = createContext("comfortable");
+/** The surface declares it: `Peek` and the narrow dialogs set it to `compact`;
+ *  a panel leaves it at `comfortable`. */
+export function DensityProvider({ value, children, }) {
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+export function useDensity() {
+    return useContext(Ctx);
+}
+/** Pick between two values according to the density, without writing the
+ *  ternary.
+ *
+ *  It exists so the difference between the two stays on ONE readable line next
+ *  to the class, and not scattered across conditionals — which is how one of
+ *  the two densities ends up unmaintained. */
+export function byDensity(d, comfortable, compact) {
+    return d === "compact" ? compact : comfortable;
+}