@qoretechnologies/reqraft 0.10.38 → 0.10.39-pr.95.g3503e91

package/.claude/CLAUDE.md

@@ -174,6 +174,18 @@ yarn build:test         # Type-check without emit
 `.github/workflows/beta_release.yml` runs on **every push to `develop`** and publishes to NPM using whatever `version` is in `package.json` at push time. A merge without a bump therefore tries to re-publish an already-published version and **fails** (NPM refuses to re-publish). This applies to **every** PR — features, fixes, chores, and docs-only changes alike. There is no exception.
 
 - Bump the **patch** for an ordinary PR while in beta (pre-1.0) — e.g. `0.10.9` → `0.10.10`. Do NOT bump minor/major for ordinary feature/fix PRs.
+- Bump **exactly once per PR**, not once per commit. If the branch has already bumped, leave it alone —
+  a second bump does not make the merge any more publishable, it just burns a version that never ships.
+  Check before you reach for it: `git diff $(git merge-base origin/develop HEAD) -- package.json`. A PR
+  that walked 0.10.36 → 0.10.46 one commit at a time is what this line exists to prevent (#95), and its
+  prereleases are stamped from `package.json`, so a base that moves every push hands consumers what look
+  like ten different release lines instead of successive previews of one.
+- Bump **exactly once per PR**, not once per commit. If the branch has already bumped, leave it alone —
+  a second bump does not make the merge any more publishable, it just burns a version that never ships.
+  Check before you reach for it: `git diff $(git merge-base origin/develop HEAD) -- package.json`. A PR
+  that walked 0.10.36 → 0.10.46 one commit at a time is what this line exists to prevent (#95), and its
+  prereleases are stamped from `package.json`, so a base that moves every push hands consumers what look
+  like ten different release lines instead of successive previews of one.
 - Bump in `package.json` only (no git tag): `npm version patch --no-git-tag-version`, and include the bump in the PR's commit.
 - If another PR bumps to the same version before yours merges, rebase and bump again — the version at merge time must be strictly greater than the last published one.
 

package/dist/components/codeSize/index.d.ts

@@ -0,0 +1,37 @@
+/// <reference types="react" />
+import { IReqoreTagProps } from '@qoretechnologies/reqore/dist/components/Tag';
+export interface IReqraftCodeSize {
+    /** Number of lines, counting a trailing newline's empty last line. */
+    lines: number;
+    /** Number of characters (UTF-16 code units, as `String.length` reports). */
+    chars: number;
+}
+/**
+ * Measure a block of code. Split out from the tag so the numbers can be
+ * asserted without rendering, and reused by callers that want to phrase the
+ * size themselves.
+ *
+ * An empty string is one line of zero characters, which is what an editor
+ * showing it displays — not zero lines.
+ */
+export declare function describeCodeSize(code: string): IReqraftCodeSize;
+/** `4 lines` / `1 line` — the label half of the chip. */
+export declare function formatCodeLines(lines: number): string;
+/** `92 chars` / `1 char` — the key half of the chip. */
+export declare function formatCodeChars(chars: number): string;
+/**
+ * The chip as plain `ReqoreTag` props. Needed wherever a host takes tag
+ * *props* rather than an element — a `ReqorePanel` `badge`, a button badge —
+ * which is most of Reqore's badge surface.
+ */
+export declare function codeSizeTagProps(code: string): IReqoreTagProps;
+export interface IReqraftCodeSizeTagProps extends Omit<IReqoreTagProps, 'label' | 'labelKey'> {
+    /** The code being summarised. */
+    code: string;
+}
+/**
+ * `N chars | N lines` chip summarising a block of source. Every prop of
+ * `ReqoreTag` passes through except the two labels, which are the point.
+ */
+export declare const ReqraftCodeSizeTag: import("react").MemoExoticComponent<({ code, ...rest }: IReqraftCodeSizeTagProps) => import("react/jsx-runtime").JSX.Element>;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/codeSize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/codeSize/index.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAG/E,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAE/D;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAW9D;AAED,MAAM,WAAW,wBACf,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC;IACnD,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,0DACT,wBAAwB,6CAK7C,CAAC"}

package/dist/components/codeSize/index.js

@@ -0,0 +1,87 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReqraftCodeSizeTag = exports.codeSizeTagProps = exports.formatCodeChars = exports.formatCodeLines = exports.describeCodeSize = void 0;
+var jsx_runtime_1 = require("react/jsx-runtime");
+// Copyright 2026 Qore Technologies, s.r.o.
+// How much code is there? — the one answer, rendered one way.
+//
+// A read-only view of source has to say something about the code it is not
+// showing in full: how many lines, how much text. The compact form engine
+// grew that chip first (a `code-editor` value's read summary); detail pages
+// outside the form engine want the identical affordance. It lives here so
+// there is one renderer rather than one per caller, each drifting in
+// pluralisation, icon and intent.
+var reqore_1 = require("@qoretechnologies/reqore");
+var react_1 = require("react");
+/**
+ * Measure a block of code. Split out from the tag so the numbers can be
+ * asserted without rendering, and reused by callers that want to phrase the
+ * size themselves.
+ *
+ * An empty string is one line of zero characters, which is what an editor
+ * showing it displays — not zero lines.
+ */
+function describeCodeSize(code) {
+    return { lines: code.split('\n').length, chars: code.length };
+}
+exports.describeCodeSize = describeCodeSize;
+/** `4 lines` / `1 line` — the label half of the chip. */
+function formatCodeLines(lines) {
+    return "".concat(lines, " ").concat(lines === 1 ? 'line' : 'lines');
+}
+exports.formatCodeLines = formatCodeLines;
+/** `92 chars` / `1 char` — the key half of the chip. */
+function formatCodeChars(chars) {
+    return "".concat(chars, " ").concat(chars === 1 ? 'char' : 'chars');
+}
+exports.formatCodeChars = formatCodeChars;
+/**
+ * The chip as plain `ReqoreTag` props. Needed wherever a host takes tag
+ * *props* rather than an element — a `ReqorePanel` `badge`, a button badge —
+ * which is most of Reqore's badge surface.
+ */
+function codeSizeTagProps(code) {
+    var _a = describeCodeSize(code), lines = _a.lines, chars = _a.chars;
+    return {
+        size: 'small',
+        minimal: true,
+        intent: 'info',
+        icon: 'CodeLine',
+        label: formatCodeLines(lines),
+        labelKey: formatCodeChars(chars),
+    };
+}
+exports.codeSizeTagProps = codeSizeTagProps;
+/**
+ * `N chars | N lines` chip summarising a block of source. Every prop of
+ * `ReqoreTag` passes through except the two labels, which are the point.
+ */
+exports.ReqraftCodeSizeTag = (0, react_1.memo)(function (_a) {
+    var code = _a.code, rest = __rest(_a, ["code"]);
+    var _b = codeSizeTagProps(code), label = _b.label, labelKey = _b.labelKey, defaults = __rest(_b, ["label", "labelKey"]);
+    return (0, jsx_runtime_1.jsx)(reqore_1.ReqoreTag, __assign({}, defaults, rest, { label: label, labelKey: labelKey }));
+});
+exports.ReqraftCodeSizeTag.displayName = 'ReqraftCodeSizeTag';
+//# sourceMappingURL=index.js.map

package/dist/components/codeSize/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/codeSize/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA2C;AAC3C,8DAA8D;AAC9D,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E;AAC1E,qEAAqE;AACrE,kCAAkC;AAElC,mDAAqD;AAErD,+BAA6B;AAS7B;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAChE,CAAC;AAFD,4CAEC;AAED,yDAAyD;AACzD,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,UAAG,KAAK,cAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAE,CAAC;AACtD,CAAC;AAFD,0CAEC;AAED,wDAAwD;AACxD,SAAgB,eAAe,CAAC,KAAa;IAC3C,OAAO,UAAG,KAAK,cAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAE,CAAC;AACtD,CAAC;AAFD,0CAEC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IACrC,IAAA,KAAmB,gBAAgB,CAAC,IAAI,CAAC,EAAvC,KAAK,WAAA,EAAE,KAAK,WAA2B,CAAC;IAEhD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;QAC7B,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC;KACjC,CAAC;AACJ,CAAC;AAXD,4CAWC;AAQD;;;GAGG;AACU,QAAA,kBAAkB,GAAG,IAAA,YAAI,EACpC,UAAC,EAA2C;IAAzC,IAAA,IAAI,UAAA,EAAK,IAAI,cAAf,QAAiB,CAAF;IACd,IAAM,KAAmC,gBAAgB,CAAC,IAAI,CAAC,EAAvD,KAAK,WAAA,EAAE,QAAQ,cAAA,EAAK,QAAQ,cAA9B,qBAAgC,CAAyB,CAAC;IAEhE,OAAO,uBAAC,kBAAS,eAAK,QAAQ,EAAM,IAAI,IAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,IAAI,CAAC;AACjF,CAAC,CACF,CAAC;AACF,0BAAkB,CAAC,WAAW,GAAG,oBAAoB,CAAC"}

package/dist/components/form/engine/CompactRow.d.ts

@@ -1,9 +1,28 @@
 import { IQorusFormField } from '@qoretechnologies/ts-toolkit';
 import React from 'react';
-export declare const CompactRow: React.MemoExoticComponent<({ optionName, optionField, hidden, clustered, clusterFirst, clusterLast, }: {
+/**
+ * The text inside a rich-text envelope, when a list item is one.
+ *
+ * An option like Gmail's `to` is `type: "list"`, `element_type: "string"`,
+ * `supports_templates: true`: each element is a plain string that may carry
+ * template tags, so its editor is a rich-text one and the element value arrives
+ * wrapped as `{type: "richtext", value: [{type: "paragraph", …}]}`.
+ *
+ * That envelope is a string in a coat, not structured data. The hash-list test
+ * unwraps `item.value`, found the Slate document — an object — and classed a
+ * list of email addresses as a list of hashes, so the row drew an expandable
+ * `type / children / text` tree instead of the address the operator typed.
+ */
+export declare const richtextItemText: (item: unknown) => string | undefined;
+export declare const CompactRow: React.MemoExoticComponent<({ optionName, optionField, hidden, clustered, clusterFirst, clusterLast, absorbedFields, }: {
     optionName: string;
     optionField: IQorusFormField;
     hidden?: boolean;
+    /** Siblings this row renders inside its own container instead of leaving
+     *  them a row each — declared by the schema's `absorb_fields`. The pair it
+     *  exists for is a code editor and its language: one decision, so one
+     *  element. */
+    absorbedFields?: string[];
     clustered?: boolean;
     clusterFirst?: boolean;
     clusterLast?: boolean;

package/dist/components/form/engine/CompactRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompactRow.d.ts","sourceRoot":"","sources":["../../../../src/components/form/engine/CompactRow.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAqC,MAAM,8BAA8B,CAAC;AAGlG,OAAO,KAAe,MAAM,OAAO,CAAC;AAkHpC,eAAO,MAAM,UAAU,yGAQlB;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,eAAe,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IAIjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,6CA4gDF,CAAC"}
+{"version":3,"file":"CompactRow.d.ts","sourceRoot":"","sources":["../../../../src/components/form/engine/CompactRow.tsx"],"names":[],"mappings":"AAcA,OAAO,EACL,eAAe,EAIhB,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAe,MAAM,OAAO,CAAC;AAsHpC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,SAAU,OAAO,KAAG,MAAM,GAAG,SAK7C,CAAC;AAEd,eAAO,MAAM,UAAU,yHASlB;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,eAAe,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;mBAGe;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAI1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,6CA63DF,CAAC"}