Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
TypeScript ai-agentsbill-of-materialserpinventory-managementleanmanufacturingmanufacturing-execution-systemmcp-servermesmrpopen-source-erppostgresqlproduction-planningqmsquality-management-systemreact-routerself-hostedsupabasetraceabilitytypescript
// SPDX-License-Identifier: AGPL-3.0-only
// Carbon (github.com/crbnos/carbon). Modified or adapted versions of this file,
// including ports, remain AGPLv3; serving them over a network requires releasing their source.
import { distinctItemText } from "@carbon/utils";
import type {
MutableRefObject,
ReactElement,
ReactNode,
RefCallback
} from "react";
import { Children, isValidElement } from "react";
/**
* Gets only the valid children of a component,
* and ignores any nullish or falsy child.
*
* @param children the children
*/
export function getValidChildren(children: ReactNode) {
return Children.toArray(children).filter((child) =>
isValidElement(child)
) as ReactElement[];
}
export const reactNodeToString = function (reactNode: ReactNode): string {
let string = "";
if (typeof reactNode === "string") {
string = reactNode;
} else if (typeof reactNode === "number") {
string = reactNode.toString();
} else if (reactNode instanceof Array) {
reactNode.forEach(function (child) {
string += reactNodeToString(child);
});
} else if (isValidElement(reactNode)) {
if (reactNode.props.value) {
// for Enumerable component
string += reactNode.props.value;
} else if (reactNode.props.status) {
// for Status components
string += reactNode.props.status;
} else {
string += reactNodeToString(reactNode.props.children);
}
}
return string;
};
/**
* The plain text of a picker option. A JSX label whose text lives in a
* component's props (an avatar that looks up its own name) has none to
* extract, so it falls back to the option's `keywords`.
*/
export function optionLabelText(option: {
label: ReactNode;
keywords?: string;
}): string {
if (typeof option.label === "string") return option.label;
return reactNodeToString(option.label) || (option.keywords ?? "");
}
export type Merge<T, P> = P & Omit<T, keyof P>;
export type MaybeRenderProp<P> = ReactNode | ((props: P) => ReactNode);
export type ReactRef<T> = RefCallback<T> | MutableRefObject<T>;
export function assignRef<T = any>(
ref: ReactRef<T> | null | undefined,
value: T
) {
if (ref == null) return;
if (typeof ref === "function") {
ref(value);
return;
}
try {
ref.current = value;
// biome-ignore lint/correctness/noUnusedVariables: suppressed due to migration
} catch (error) {
throw new Error(`Cannot assign value '${value}' to ref '${ref}'`);
}
}
export function mergeRefs<T>(...refs: (ReactRef<T> | null | undefined)[]) {
return (node: T | null) => {
refs.forEach((ref) => {
assignRef(ref, node);
});
};
}
/**
* Drops an option's `helper` when it only repeats the option's label — an item
* picker shows the readable id with the name beneath it, and a service's
* readable id IS its name. Returns the same array when nothing changes, so a
* memoized caller keeps a stable reference.
*/
export function withDistinctHelpers<
T extends { label: ReactNode; helper?: string }
>(options: T[]): T[] {
let out: T[] | undefined;
for (let i = 0; i < options.length; i++) {
const option = options[i]!;
if (!option.helper) continue;
const label =
typeof option.label === "string"
? option.label
: reactNodeToString(option.label);
if (distinctItemText(label, option.helper) !== undefined) continue;
out ??= options.slice();
out[i] = { ...option, helper: undefined };
}
return out ?? options;
}