@stencitecnologia/utils 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# @stencitecnologia/utils
+
+Funções utilitárias puras: formatação de datas, strings, documentos brasileiros (CPF, CNPJ), telefone, endereço, e validadores. JavaScript framework-agnostic. Única dependência: `dayjs`.
+
+## Instalação
+
+```sh
+npm install @stencitecnologia/utils
+```
+
+`dayjs` é instalado automaticamente como dependência.
+
+## Uso
+
+```js
+import {
+  formatDate,
+  formatPhone,
+  onlyNumber,
+  isValidCPF,
+  addMonths,
+  today,
+} from '@stencitecnologia/utils';
+
+// Exibição
+formatDate(record.createdAt);                    // '14/05/2026'
+formatPhone(onlyNumber('+55 (11) 99999-9999'));  // '(11) 99999-9999'
+
+// Validação (sempre passe o valor já limpo)
+const digits = onlyNumber(rawInput);
+if (isValidCPF(digits)) {
+  // CPF válido
+}
+
+// Aritmética de datas
+const proximoMes = addMonths(today(), 1);
+```
+
+## Referência — datas
+
+Internamente usa `dayjs` configurado com locale `pt-BR` e os plugins `customParseFormat`, `localizedFormat`, `utc`, `timezone`.
+
+Tipos aceitos: `Date | string | number | dayjs`. Formatos string aceitos: `YYYY-MM-DD`, `YYYY-MM-DDTHH:mm:ss`, `DD/MM/YYYY`, `DD/MM/YYYY HH:mm`, `DD/MM/YYYY HH:mm:ss`.
+
+| Função | Assinatura | Descrição |
+|---|---|---|
+| `formatDate` | `(date, format?) => string` | Default `'DD/MM/YYYY'`. |
+| `formatDateTime` | `(date, format?) => string` | Default `'DD/MM/YYYY HH:mm'`. |
+| `formatTime` | `(date, format?) => string` | Default `'HH:mm'`. |
+| `formatWeekday` | `(date, format?) => string` | Default `'ddd'` em caixa alta (`'SEG'`). |
+| `formatFullDate` | `(date, format?) => string` | Default `'dddd, DD[ de ]MMMM[ de ]YYYY'`. |
+| `formatDateToApi` | `(date, format?) => string` | Default `'YYYY-MM-DD'`. |
+| `formatDateTimeToApi` | `(date, format?) => string` | Default `'YYYY-MM-DD HH:mm:ss'`. |
+| `toDate` | `(value) => Date \| null` | Converte para `Date` nativo ou retorna `null`. |
+| `startOfDay` | `(date) => Date` | Meia-noite da data informada. |
+| `today` | `() => Date` | Hoje à meia-noite. |
+| `add` | `(date, amount, unit?) => Date` | Unit default: `'day'`. |
+| `addDays` | `(date, days) => Date` | |
+| `addMonths` | `(date, months) => Date` | |
+| `addYears` | `(date, years) => Date` | |
+| `addMinutes` | `(date, minutes) => Date` | |
+
+## Referência — strings
+
+| Função | Assinatura | Descrição |
+|---|---|---|
+| `getInitials` | `(name: string) => string` | Primeira letra das duas primeiras palavras, em caixa alta. `'John Doe Smith' → 'JD'`. |
+| `toCamelCaseWords` | `(value: string) => string` | Title-case por palavra. `'hello world' → 'Hello World'`. |
+| `onlyNumber` | `(value: string) => string` | Remove tudo que não for dígito. |
+| `formatDocument` | `(value: string \| null) => string` | Formata como CPF (11 dígitos) ou CNPJ (14 dígitos). Retorna `'-'` para vazio. |
+| `formatNumber` | `(value: number, decimals?) => string` | Locale pt-BR. Default 2 casas. `1234.5 → '1.234,50'`. |
+| `shortCode` | `(objectId: string) => string` | Últimos 8 caracteres em caixa alta. |
+
+## Referência — formatadores
+
+| Função | Assinatura | Descrição |
+|---|---|---|
+| `formatPhone` | `(value: string) => string` | Aceita dígitos crus (com ou sem `55`). 11 dígitos → `(XX) XXXXX-XXXX`, 10 → `(XX) XXXX-XXXX`. |
+| `formatAddress` | `(address) => string` | Recebe `{ postalCode, state, city, neighborhood, addressLine1, addressLine2? }`. CEP renderizado como `XXXXX-XXX`. |
+| `formatCouncil` | `(council) => string` | Recebe `{ name, state, record }`. Retorna `'name state record'`. |
+
+## Referência — validadores
+
+Predicados puros `(value) => boolean`. **Recebem o valor já limpo** (use `onlyNumber()` antes para documentos/telefones).
+
+| Função | Assinatura | Descrição |
+|---|---|---|
+| `isValidCPF` | `(value: string) => boolean` | 11 dígitos, valida dígitos verificadores. |
+| `isValidCNPJ` | `(value: string) => boolean` | 14 dígitos, valida com pesos. |
+| `isValidCellphone` | `(value: string) => boolean` | Vazio OU exatamente 11 dígitos. |
+| `isValidPhone` | `(value: string) => boolean` | Vazio OU exatamente 10 dígitos. |
+| `isValidPostalCode` | `(value: string) => boolean` | Exatamente 8 dígitos. |
+| `isValidDate` | `(value: Date \| string) => boolean` | |
+| `isFutureDate` | `(value: Date, baseDate?: Date) => boolean` | `baseDate` default: hoje. |
+| `isValidDateRange` | `(value: [Date \| null, Date \| null]) => boolean` | `end >= start`. |
+| `isOnlyNumbers` | `(value: string) => boolean` | |
+| `isValidFullName` | `(value: string) => boolean` | ≥2 tokens, sem caracteres especiais (exceto `'` e `-`), ≥2 chars por token. |
+
+## Restrições
+
+- Nunca importe `dayjs` diretamente — use as funções deste pacote para garantir locale e plugins corretos.
+- Validadores não fazem stripping. Chame `onlyNumber()` antes de `isValidCPF`, `isValidCellphone` etc.
+- Nada de imports de `vue`, `vue-router`, `pinia`, `primevue`, `@vuelidate/*` ou `axios`.

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("dayjs");require("dayjs/locale/pt-br.js");const h=require("dayjs/plugin/customParseFormat.js"),M=require("dayjs/plugin/localizedFormat.js"),y=require("dayjs/plugin/utc.js"),C=require("dayjs/plugin/timezone.js");i.extend(h);i.extend(M);i.extend(y);i.extend(C);i.locale("pt-br");const $=["YYYY-MM-DD","YYYY-MM-DDTHH:mm:ss","YYYY-MM-DDTHH:mm:ssZ","YYYY-MM-DDTHH:mm","DD/MM/YYYY","DD/MM/YY"],o=t=>{if(t==null||t==="")return null;if(t instanceof Date){const n=i(t);return n.isValid()?n:null}if(typeof t=="string"){const n=i(t.trim(),$,"pt-br",!0);return n.isValid()?n:null}const e=i(t);return e.isValid()?e:null};function p(t){const e=o(t);return e?e.startOf("day").toDate():null}function V(){return i().startOf("day").toDate()}function N(t,e="YYYY-MM-DD"){const n=o(t);return n?n.format(e):""}function b(t,e="YYYY-MM-DD HH:mm:ss"){const n=o(t);return n?n.format(e):""}function A(t,e="DD/MM/YYYY"){const n=o(t);return n?n.format(e):""}function T(t,e="DD/MM/YYYY HH:mm"){const n=o(t);return n?n.format(e):""}function F(t,e="HH:mm"){const n=o(t);return n?n.format(e):""}function P(t,e="ddd"){const n=o(t);return n?n.format(e).toUpperCase():""}function H(t,e="dddd, DD[ de ]MMMM[ de ]YYYY"){const n=o(t);return n?n.format(e):""}function Y(t){const e=o(t);return e?e.toDate():null}function m(t,e,n="day"){const r=o(t);return!r||typeof e!="number"||Number.isNaN(e)?null:r.add(e,n).toDate()}function j(t,e){return m(t,e,"day")}function O(t,e){return m(t,e,"month")}function S(t,e){return m(t,e,"year")}function q(t,e){return m(t,e,"minute")}function B(t){return t?t.trim().split(/\s+/).slice(0,2).map(e=>e[0].toUpperCase()).join(""):""}function R(t){return t==null?"":String(t).toLowerCase().trim().split(/\s+/).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(" ")}function d(t){return t==null?"":String(t).replace(/\D/g,"")}const W=t=>{if(!t)return"-";const e=t.replace(/\D/g,"");return e.length===11?e.replace(/(\d{3})(\d{3})(\d{3})(\d{2})/,"$1.$2.$3-$4"):e.length===14?e.replace(/(\d{2})(\d{3})(\d{3})(\d{4})(\d{2})/,"$1.$2.$3/$4-$5"):t},x=(t,e=2)=>t==null?"-":Number(t).toLocaleString("pt-BR",{minimumFractionDigits:e,maximumFractionDigits:e});function z(t){const e=d(t);return e.length!==8?t:e.replace(/(\d{5})(\d{3})/,"$1-$2")}function L(t){if(t==null)return"";const{postalCode:e,state:n,city:r,neighborhood:s,addressLine1:a,addressLine2:c}=t,f=[a,c].filter(Boolean).join(" "),l=[s," - ",r,n].filter(Boolean).join(" "),u=e?z(e):null;return[f," - ",l," - ",u].filter(Boolean).join(" ").replace(/\s-\s$/,"")}function U(t){if(t==null)return"";const{name:e,state:n,record:r}=t;return[e,n,r].filter(Boolean).join(" ")}function w(t){const e=d(t);if(!e)return"";const n=e.startsWith("55")&&e.length>11?e.slice(2):e;return n.length===11?n.replace(/(\d{2})(\d{5})(\d{4})/,"($1) $2-$3"):n.length===10?n.replace(/(\d{2})(\d{4})(\d{4})/,"($1) $2-$3"):t}function Z(t){return t?t.toString().slice(-8).toUpperCase():""}function k(t){const e=d(t);if(!e||e.length!==11||/^(\d)\1+$/.test(e))return!1;const n=(a,c)=>{let f=0;for(let u=0;u<a.length;u+=1)f+=Number(a[u])*(c-u);const l=f%11;return l<2?0:11-l},r=n(e.slice(0,9),10),s=n(e.slice(0,10),11);return r===Number(e[9])&&s===Number(e[10])}function E(t){const e=d(t);if(!e||e.length!==14||/^(\d)\1+$/.test(e))return!1;const n=(f,l)=>{let u=0;for(let D=0;D<f.length;D+=1)u+=Number(f[D])*l[D];const g=u%11;return g<2?0:11-g},r=[5,4,3,2,9,8,7,6,5,4,3,2],s=[6,5,4,3,2,9,8,7,6,5,4,3,2],a=n(e.slice(0,12),r),c=n(e.slice(0,13),s);return a===Number(e[12])&&c===Number(e[13])}function J(t,e=new Date){const n=Y(t);if(!n)return!1;const r=p(e);return p(n)>r}function _(t){const e=Y(t);return!!e&&i(e).isValid()}function I(t){if(!Array.isArray(t)||!t[0]||!t[1])return!1;const[e,n]=t;return!(e instanceof Date)||!(n instanceof Date)?!1:n>=e}function G(t){const e=d(t||"");return e?e.length===11:!0}function K(t){const e=d(t||"");return e?e.length===10:!0}function Q(t){return t.replace(/\D/g,"").length===8}function X(t){if(t==null)return!1;const e=String(t).trim();return e?/^\d+$/.test(e):!1}function v(t){return/^[A-Za-zÀ-ÖØ-öø-ÿ\s'-]+$/u.test(t)}function tt(t){return t.endsWith(".")||t.length<2}function et(t){const e=(t||"").trim();if(!e||!v(e))return!1;const n=e.split(" ").filter(Boolean);if(n.length<2)return!1;const r=/^[A-Za-zÀ-ÖØ-öø-ÿ]+(?:[-'][A-Za-zÀ-ÖØ-öø-ÿ]+)*$/u;return n.every(s=>{const a=s.replace(/^[-']+|[-']+$/g,"");return!a||tt(a)?!1:r.test(s)})}exports.add=m;exports.addDays=j;exports.addMinutes=q;exports.addMonths=O;exports.addYears=S;exports.formatAddress=L;exports.formatCouncil=U;exports.formatDate=A;exports.formatDateTime=T;exports.formatDateTimeToApi=b;exports.formatDateToApi=N;exports.formatDocument=W;exports.formatFullDate=H;exports.formatNumber=x;exports.formatPhone=w;exports.formatTime=F;exports.formatWeekday=P;exports.getInitials=B;exports.isFutureDate=J;exports.isOnlyNumbers=X;exports.isValidCNPJ=E;exports.isValidCPF=k;exports.isValidCellphone=G;exports.isValidDate=_;exports.isValidDateRange=I;exports.isValidFullName=et;exports.isValidPhone=K;exports.isValidPostalCode=Q;exports.onlyNumber=d;exports.shortCode=Z;exports.startOfDay=p;exports.toCamelCaseWords=R;exports.toDate=Y;exports.today=V;

package/dist/index.es.js

@@ -0,0 +1,241 @@
+import i from "dayjs";
+import "dayjs/locale/pt-br.js";
+import h from "dayjs/plugin/customParseFormat.js";
+import M from "dayjs/plugin/localizedFormat.js";
+import $ from "dayjs/plugin/utc.js";
+import y from "dayjs/plugin/timezone.js";
+i.extend(h);
+i.extend(M);
+i.extend($);
+i.extend(y);
+i.locale("pt-br");
+const C = [
+  "YYYY-MM-DD",
+  "YYYY-MM-DDTHH:mm:ss",
+  "YYYY-MM-DDTHH:mm:ssZ",
+  "YYYY-MM-DDTHH:mm",
+  "DD/MM/YYYY",
+  "DD/MM/YY"
+], o = (t) => {
+  if (t == null || t === "") return null;
+  if (t instanceof Date) {
+    const r = i(t);
+    return r.isValid() ? r : null;
+  }
+  if (typeof t == "string") {
+    const r = i(t.trim(), C, "pt-br", !0);
+    return r.isValid() ? r : null;
+  }
+  const n = i(t);
+  return n.isValid() ? n : null;
+};
+function Y(t) {
+  const n = o(t);
+  return n ? n.startOf("day").toDate() : null;
+}
+function S() {
+  return i().startOf("day").toDate();
+}
+function x(t, n = "YYYY-MM-DD") {
+  const r = o(t);
+  return r ? r.format(n) : "";
+}
+function B(t, n = "YYYY-MM-DD HH:mm:ss") {
+  const r = o(t);
+  return r ? r.format(n) : "";
+}
+function O(t, n = "DD/MM/YYYY") {
+  const r = o(t);
+  return r ? r.format(n) : "";
+}
+function z(t, n = "DD/MM/YYYY HH:mm") {
+  const r = o(t);
+  return r ? r.format(n) : "";
+}
+function L(t, n = "HH:mm") {
+  const r = o(t);
+  return r ? r.format(n) : "";
+}
+function R(t, n = "ddd") {
+  const r = o(t);
+  return r ? r.format(n).toUpperCase() : "";
+}
+function U(t, n = "dddd, DD[ de ]MMMM[ de ]YYYY") {
+  const r = o(t);
+  return r ? r.format(n) : "";
+}
+function g(t) {
+  const n = o(t);
+  return n ? n.toDate() : null;
+}
+function p(t, n, r = "day") {
+  const e = o(t);
+  return !e || typeof n != "number" || Number.isNaN(n) ? null : e.add(n, r).toDate();
+}
+function w(t, n) {
+  return p(t, n, "day");
+}
+function W(t, n) {
+  return p(t, n, "month");
+}
+function Z(t, n) {
+  return p(t, n, "year");
+}
+function k(t, n) {
+  return p(t, n, "minute");
+}
+function E(t) {
+  return t ? t.trim().split(/\s+/).slice(0, 2).map((n) => n[0].toUpperCase()).join("") : "";
+}
+function _(t) {
+  return t == null ? "" : String(t).toLowerCase().trim().split(/\s+/).map((n) => n.charAt(0).toUpperCase() + n.slice(1)).join(" ");
+}
+function d(t) {
+  return t == null ? "" : String(t).replace(/\D/g, "");
+}
+const J = (t) => {
+  if (!t) return "-";
+  const n = t.replace(/\D/g, "");
+  return n.length === 11 ? n.replace(/(\d{3})(\d{3})(\d{3})(\d{2})/, "$1.$2.$3-$4") : n.length === 14 ? n.replace(/(\d{2})(\d{3})(\d{3})(\d{4})(\d{2})/, "$1.$2.$3/$4-$5") : t;
+}, q = (t, n = 2) => t == null ? "-" : Number(t).toLocaleString("pt-BR", {
+  minimumFractionDigits: n,
+  maximumFractionDigits: n
+});
+function N(t) {
+  const n = d(t);
+  return n.length !== 8 ? t : n.replace(/(\d{5})(\d{3})/, "$1-$2");
+}
+function G(t) {
+  if (t == null) return "";
+  const {
+    postalCode: n,
+    state: r,
+    city: e,
+    neighborhood: s,
+    addressLine1: u,
+    addressLine2: l
+  } = t, a = [u, l].filter(Boolean).join(" "), c = [s, " - ", e, r].filter(Boolean).join(" "), f = n ? N(n) : null;
+  return [a, " - ", c, " - ", f].filter(Boolean).join(" ").replace(/\s-\s$/, "");
+}
+function I(t) {
+  if (t == null) return "";
+  const { name: n, state: r, record: e } = t;
+  return [n, r, e].filter(Boolean).join(" ");
+}
+function K(t) {
+  const n = d(t);
+  if (!n) return "";
+  const r = n.startsWith("55") && n.length > 11 ? n.slice(2) : n;
+  return r.length === 11 ? r.replace(/(\d{2})(\d{5})(\d{4})/, "($1) $2-$3") : r.length === 10 ? r.replace(/(\d{2})(\d{4})(\d{4})/, "($1) $2-$3") : t;
+}
+function Q(t) {
+  return t ? t.toString().slice(-8).toUpperCase() : "";
+}
+function X(t) {
+  const n = d(t);
+  if (!n || n.length !== 11 || /^(\d)\1+$/.test(n)) return !1;
+  const r = (u, l) => {
+    let a = 0;
+    for (let f = 0; f < u.length; f += 1)
+      a += Number(u[f]) * (l - f);
+    const c = a % 11;
+    return c < 2 ? 0 : 11 - c;
+  }, e = r(n.slice(0, 9), 10), s = r(n.slice(0, 10), 11);
+  return e === Number(n[9]) && s === Number(n[10]);
+}
+function v(t) {
+  const n = d(t);
+  if (!n || n.length !== 14 || /^(\d)\1+$/.test(n)) return !1;
+  const r = (a, c) => {
+    let f = 0;
+    for (let m = 0; m < a.length; m += 1)
+      f += Number(a[m]) * c[m];
+    const D = f % 11;
+    return D < 2 ? 0 : 11 - D;
+  }, e = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2], s = [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2], u = r(n.slice(0, 12), e), l = r(n.slice(0, 13), s);
+  return u === Number(n[12]) && l === Number(n[13]);
+}
+function tt(t, n = /* @__PURE__ */ new Date()) {
+  const r = g(t);
+  if (!r) return !1;
+  const e = Y(n);
+  return Y(r) > e;
+}
+function nt(t) {
+  const n = g(t);
+  return !!n && i(n).isValid();
+}
+function rt(t) {
+  if (!Array.isArray(t) || !t[0] || !t[1]) return !1;
+  const [n, r] = t;
+  return !(n instanceof Date) || !(r instanceof Date) ? !1 : r >= n;
+}
+function et(t) {
+  const n = d(t || "");
+  return n ? n.length === 11 : !0;
+}
+function it(t) {
+  const n = d(t || "");
+  return n ? n.length === 10 : !0;
+}
+function ot(t) {
+  return t.replace(/\D/g, "").length === 8;
+}
+function st(t) {
+  if (t == null) return !1;
+  const n = String(t).trim();
+  return n ? /^\d+$/.test(n) : !1;
+}
+function b(t) {
+  return /^[A-Za-zÀ-ÖØ-öø-ÿ\s'-]+$/u.test(t);
+}
+function A(t) {
+  return t.endsWith(".") || t.length < 2;
+}
+function ut(t) {
+  const n = (t || "").trim();
+  if (!n || !b(n)) return !1;
+  const r = n.split(" ").filter(Boolean);
+  if (r.length < 2) return !1;
+  const e = /^[A-Za-zÀ-ÖØ-öø-ÿ]+(?:[-'][A-Za-zÀ-ÖØ-öø-ÿ]+)*$/u;
+  return r.every((s) => {
+    const u = s.replace(/^[-']+|[-']+$/g, "");
+    return !u || A(u) ? !1 : e.test(s);
+  });
+}
+export {
+  p as add,
+  w as addDays,
+  k as addMinutes,
+  W as addMonths,
+  Z as addYears,
+  G as formatAddress,
+  I as formatCouncil,
+  O as formatDate,
+  z as formatDateTime,
+  B as formatDateTimeToApi,
+  x as formatDateToApi,
+  J as formatDocument,
+  U as formatFullDate,
+  q as formatNumber,
+  K as formatPhone,
+  L as formatTime,
+  R as formatWeekday,
+  E as getInitials,
+  tt as isFutureDate,
+  st as isOnlyNumbers,
+  v as isValidCNPJ,
+  X as isValidCPF,
+  et as isValidCellphone,
+  nt as isValidDate,
+  rt as isValidDateRange,
+  ut as isValidFullName,
+  it as isValidPhone,
+  ot as isValidPostalCode,
+  d as onlyNumber,
+  Q as shortCode,
+  Y as startOfDay,
+  _ as toCamelCaseWords,
+  g as toDate,
+  S as today
+};

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@stencitecnologia/utils",
+  "version": "0.1.0",
+  "description": "Pure utility functions: validators, formatters, and date helpers. Framework-agnostic.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.es.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "vite build"
+  },
+  "dependencies": {
+    "dayjs": "^1.11.19"
+  }
+}