stacks 0.47.2 → 0.48.1

package/core/strings/src/utils.ts

@@ -0,0 +1,80 @@
+/**
+ * Replace backslash to slash
+ *
+ * @category String
+ */
+export function slash(str: string) {
+  return str.replace(/\\/g, '/')
+}
+
+/**
+ * Ensure prefix of a string
+ *
+ * @category String
+ */
+export function ensurePrefix(prefix: string, str: string) {
+  if (!str.startsWith(prefix))
+    return prefix + str
+  return str
+}
+
+/**
+ * Ensure suffix of a string
+ *
+ * @category String
+ */
+export function ensureSuffix(suffix: string, str: string) {
+  if (!str.endsWith(suffix))
+    return str + suffix
+  return str
+}
+
+/**
+ * Dead simple template engine, just like Python's `.format()`
+ *
+ * @category String
+ * @example
+ * ```
+ * const result = template(
+ *   'Hello {0}! My name is {1}.',
+ *   'Buddy',
+ *   'Chris'
+ * ) // Hello Buddy! My name is Chris.
+ * ```
+ */
+export function template(str: string, ...args: any[]): string {
+  return str.replace(/{(\d+)}/g, (match, key) => {
+    const index = Number(key)
+    if (Number.isNaN(index))
+      return match
+    return args[index]
+  })
+}
+
+// port from nanoid
+// https://github.com/ai/nanoid
+const urlAlphabet = 'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict'
+/**
+ * Generate a random string
+ * @category String
+ */
+export function randomStr(size = 16, dict = urlAlphabet) {
+  let id = ''
+  let i = size
+  const len = dict.length
+  while (i--)
+    id += dict[(Math.random() * len) | 0]
+  return id
+}
+
+/**
+ * First letter uppercase, other lowercase
+ * @category string
+ * @example
+ * ```
+ * capitalize('hello') => 'Hello'
+ * ```
+ */
+export function capitalize(str: string): string {
+  return str[0].toUpperCase() + str.slice(1).toLowerCase()
+}

package/core/strings/src/validation.ts

@@ -0,0 +1,182 @@
+import validator from 'validator'
+import type { HashAlgorithm } from '@stacksjs/types'
+
+export function isEmail(email: string) {
+  return validator.isEmail(email)
+}
+
+export function isStrongPassword(password: string) {
+  return validator.isStrongPassword(password)
+}
+
+export function isAlphanumeric(username: string) {
+  return validator.isAlphanumeric(username)
+}
+
+export function validateUsername(username: string) {
+  return isAlphanumeric(username)
+}
+
+export function isURL(url: string) {
+  return validator.isURL(url)
+}
+
+export function isMobilePhone(phoneNumber: string) {
+  return validator.isMobilePhone(phoneNumber)
+}
+
+export function isAlpha(name: string) {
+  return validator.isAlpha(name)
+}
+
+export function isPostalCode(zipCode: string) {
+  return validator.isPostalCode(zipCode, 'any')
+}
+
+export function isDate(date: string) {
+  return validator.isDate(date)
+}
+
+export function isNumeric(number: string) {
+  return validator.isNumeric(number)
+}
+
+export function isBoolean(boolean: string) {
+  return validator.isBoolean(boolean)
+}
+
+export function isHexColor(color: string) {
+  return validator.isHexColor(color)
+}
+
+export function isHexadecimal(hex: string) {
+  return validator.isHexadecimal(hex)
+}
+
+export function isBase64(base64: string) {
+  return validator.isBase64(base64)
+}
+
+export function isUUID(uuid: string) {
+  return validator.isUUID(uuid)
+}
+
+export function isJSON(json: string) {
+  return validator.isJSON(json)
+}
+
+export function isCreditCard(creditCard: string) {
+  return validator.isCreditCard(creditCard)
+}
+
+export function isISBN(isbn: string) {
+  return validator.isISBN(isbn)
+}
+
+export function isIP(ip: string) {
+  return validator.isIP(ip)
+}
+
+export function isIPRange(ip: string) {
+  return validator.isIPRange(ip)
+}
+
+export function isMACAddress(macAddress: string) {
+  return validator.isMACAddress(macAddress)
+}
+
+export function isLatLong(latitude: string) {
+  return validator.isLatLong(latitude)
+}
+
+export function isLatitude(longitude: string) {
+  return validator.isLatLong(longitude)
+}
+
+export function isLongitude(longitude: string) {
+  return validator.isLatLong(longitude)
+}
+
+export function isCurrency(currency: string) {
+  return validator.isCurrency(currency)
+}
+
+export function isDataURI(dataURI: string) {
+  return validator.isDataURI(dataURI)
+}
+
+export function isMimeType(mimeType: string) {
+  return validator.isMimeType(mimeType)
+}
+
+export function isJWT(jwt: string) {
+  return validator.isJWT(jwt)
+}
+
+export function isMongoId(mongoId: string) {
+  return validator.isMongoId(mongoId)
+}
+
+export function isAscii(ascii: string) {
+  return validator.isAscii(ascii)
+}
+
+export function isBase32(base32: string) {
+  return validator.isBase32(base32)
+}
+
+export function isByteLength(byteLength: string) {
+  return validator.isByteLength(byteLength)
+}
+
+export function isFQDN(fqdn: string) {
+  return validator.isFQDN(fqdn)
+}
+
+export function isFullWidth(fullWidth: string) {
+  return validator.isFullWidth(fullWidth)
+}
+
+export function isHalfWidth(halfWidth: string) {
+  return validator.isHalfWidth(halfWidth)
+}
+
+export function isHash(hash: string, algorithm: HashAlgorithm) {
+  return validator.isHash(hash, algorithm)
+}
+
+export function isHSL(hsl: string) {
+  return validator.isHSL(hsl)
+}
+
+export function isIBAN(iban: string) {
+  return validator.isIBAN(iban)
+}
+
+export function isIdentityCard(identityCard: string) {
+  return validator.isIdentityCard(identityCard)
+}
+
+export function isISIN(isin: string) {
+  return validator.isISIN(isin)
+}
+
+export function isISO8601(iso8601: string) {
+  return validator.isISO8601(iso8601)
+}
+
+export function isISRC(isrc: string) {
+  return validator.isISRC(isrc)
+}
+
+export function isISSN(issn: string) {
+  return validator.isISSN(issn)
+}
+
+export function isISO31661Alpha2(iso31661Alpha2: string) {
+  return validator.isISO31661Alpha2(iso31661Alpha2)
+}
+
+export function isISO31661Alpha3(iso31661Alpha3: string) {
+  return validator.isISO31661Alpha3(iso31661Alpha3)
+}

package/core/tables/README.md

@@ -0,0 +1,109 @@
+# Table Stack
+
+The easy & modern way to work with tables of any size. Blazing-fast searching, filtering, sorting, and paginating. Powered by your search engine of choice. Kick-start the development of a feature-rich & configurable table UI, including a beautiful default UX.
+
+## 🐙 Features
+
+This Vue component library comes with the following features, improvements to the `table` element:
+
+- `<table-v2 />`
+  - quickly spin up a highly-configurable table UI without worrying about the backend
+  - "facet-filtering" & "table head sorting" natively built-in
+  - Meilisearch & Laravel Scout API compatible
+  - Enterprise-ready
+  - _Soon: Algolia & Typesense integration_
+
+Get granular control over the table appearance & behavior, with the following (optional) components:
+
+- `<table-search />`
+  - configure your search input for blazing fast search results
+
+- `<table-filters />`
+  - overwrite the default display of your table's filters
+
+- `<table-pagination />`
+  - easily configure the pagination of your table
+
+- `<table-configure />`
+  - simple way to configure the table in HTML semantic fashion
+
+Read more about these features in their respective [docs](https://ow3.org/docs).
+
+## 💡 Get Started
+
+To get started, you simply need to install the `@ow3/table-vue` npm package.
+
+```bash
+npm install @ow3/table-vue
+```
+
+Next up, we need to make use of the components.
+
+```vue
+<script setup>
+import { Table as TableV2 } from 'table-vue'
+</script>
+
+<template>
+  <!-- the `type`-property indicates to to the search engine the "index" you want to target -->
+  <TableV2 type="movies" />
+
+  <!-- these are the default properties (all of them are optional)  -->
+  <TableV2
+    source="127.0.0.1:7700"
+    columns="*"
+    :searchable="true"
+    :filterable="true"
+    :sortable="true"
+    :actionable="true"
+    :selectable="false"
+    :per-page="20"
+  />
+
+  <!-- another "data table" example -->
+  <TableV2
+    source="127.0.0.1:7700"
+    password="NtUvZv5Q87e355b807622149c350ac38679645b4e2603a1d3eb48cda080f977e76329aeb"
+    type="orders"
+    columns="id: Order, customer_name: Customer, customer_po: PO#, part_name: Part, created_at: Ordered, due_at: Due, stage_name: Status"
+    sort="id:desc"
+    sorts="id, customer_name, customer_po, part_name, stage_name, due_at, created_at"
+    filters="customer_name, vendor_name, part_name, document_types"
+    actions="Edit"
+    per-page="10"
+    selectable="true"
+  />
+</template>
+```
+
+To learn more about what's possible & how to best build modern data tables, check out our documentation.
+
+## 🧪 Testing
+
+```bash
+yarn test
+```
+
+## 📈 Changelog
+
+Please see our [releases](https://github.com/stacksjs/table/releases) page for more information on what has changed recently.
+
+## 💪🏼 Contributing
+
+Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.
+
+## 🏝 Community
+
+For help, discussion about best practices, or any other conversation that would benefit from being searchable:
+
+[Table Elements on GitHub](https://github.com/stacksjs/table/discussions)
+
+For casual chit-chat with others using this package:
+
+[Join the Open Web Discord Server](https://discord.ow3.org)
+
+## 📄 License
+
+The MIT License (MIT). Please see [LICENSE](LICENSE.md) for more information.
+
+Made with ❤️ by Open Web Labs.

package/core/tables/examples/vue/App.vue

@@ -0,0 +1,12 @@
+<!--
+  This is how you would implement your generated
+  library into your own frontend. You may import
+  any of the components developed.
+-->
+<script setup lang="ts">
+import { Demo } from './dist/index.mjs'
+</script>
+
+<template>
+  <Demo />
+</template>

package/core/tables/examples/vue/index.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href="./favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Stacks Vue Example</title>
+    <link rel="stylesheet" href="./dist/style.css">
+  </head>
+  <body>
+    <div id="app"></div>
+
+    <script type="module">
+      import { createApp } from 'vue'
+      import App from './App.vue'
+
+      createApp(App).mount('#app')
+    </script>
+  </body>
+</html>

package/core/tables/examples/web/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href="./favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Stacks Web Component Example</title>
+  </head>
+  <body>
+    <script type="module" src="./dist/index.mjs"></script>
+    <hello-world></hello-world>
+  </body>
+</html>

package/core/tables/node_modules/.bin/mkdist

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/mkdist@1.0.0_typescript@4.9.4/node_modules/mkdist/dist/cli.cjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/mkdist@1.0.0_typescript@4.9.4/node_modules/mkdist/dist/cli.cjs" "$@"
+fi

package/core/tables/node_modules/.bin/tsc

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsc" "$@"
+fi

package/core/tables/node_modules/.bin/tsserver

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@4.9.4/node_modules/typescript/bin/tsserver" "$@"
+fi

package/core/tables/node_modules/.bin/unbuild

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="$NODE_PATH:/home/runner/work/stacks/stacks/node_modules/.pnpm/node_modules"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/unbuild@1.0.2/node_modules/unbuild/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/unbuild@1.0.2/node_modules/unbuild/dist/cli.mjs" "$@"
+fi

package/core/tables/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@stacksjs/tables",
+  "version": "0.48.1",
+  "description": "The easy & modern way to work with tables. Facet filtering, searching, pagination, ...",
+  "author": "Open Web Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stacksjs/tables.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/tables/issues"
+  },
+  "keywords": [
+    "tables",
+    "filters",
+    "pagination",
+    "sorting",
+    "search",
+    "component",
+    "library",
+    "vue",
+    "typescript",
+    "javascript"
+  ],
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "engines": {
+    "node": ">=v18.12.1",
+    "pnpm": ">=7.21.0"
+  },
+  "scripts": {
+    "dev": "pnpm buddy dev",
+    "dev:components": "pnpm buddy dev:components",
+    "dev:docs": "pnpm buddy dev:docs",
+    "dev:functions": "pnpm buddy dev:functions // todo: opens the auto-generated web server of functions",
+    "development": "pnpm buddy dev",
+    "build": "pnpm buddy build",
+    "build:components": "pnpm buddy build:components",
+    "build:vue-components": "pnpm buddy build:web-components",
+    "build:web-components": "pnpm buddy build:web-components",
+    "build:functions": "pnpm buddy build:functions // needs to have option to ",
+    "build:docs": "pnpm buddy build:docs",
+    "prod": "pnpm buddy build",
+    "prod:components": "pnpm buddy build:components",
+    "prod:vue-components": "pnpm buddy build:web-components",
+    "prod:web-components": "pnpm buddy build:web-components",
+    "prod:functions": "pnpm buddy build:functions // needs to have option to ",
+    "prod:docs": "pnpm buddy build:docs",
+    "production": "pnpm buddy build",
+    "deploy": "pnpm buddy deploy",
+    "deploy:functions": "pnpm buddy deploy:functions",
+    "deploy:pages": "pnpm buddy deploy:functions",
+    "deploy:docs": "pnpm buddy deploy:docs",
+    "deploy:all": "pnpm buddy deploy:all",
+    "lint": "pnpm buddy lint",
+    "lint:fix": "pnpm buddy lint:fix",
+    "serve": "pnpm buddy dev",
+    "serve:pages": "pnpm buddy dev:pages",
+    "serve:functions": "pnpm buddy dev:functions",
+    "make": "pnpm buddy make",
+    "make:table": "pnpm buddy make:table",
+    "commit": "pnpm buddy commit",
+    "release": "pnpm buddy release",
+    "changelog": "pnpm buddy changelog",
+    "generate": "pnpm buddy generate",
+    "generate:entries": "pnpm buddy generate:entries",
+    "generate:vue-compat": "pnpm buddy generate:vue-compat",
+    "generate:vscode-custom-data": "pnpm buddy generate:vscode-custom-data",
+    "generate:web-types": "pnpm buddy generate:web-types",
+    "generate:component-meta": "pnpm buddy generate:component-meta",
+    "test": "pnpm buddy test",
+    "test:coverage": "pnpm buddy test:coverage",
+    "test:types": "pnpm buddy test:types"
+  },
+  "peerDependencies": {
+    "@stacksjs/types": "workspace:*",
+    "@stacksjs/utils": "workspace:*",
+    "@vueform/multiselect": "^2.4.2",
+    "meilisearch": "^0.25.1"
+  },
+  "devDependencies": {
+    "@stacksjs/testing": "workspace:*",
+    "mkdist": "^1.0.0",
+    "typescript": "^4.9.4",
+    "unbuild": "^1.0.2"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,vue}": "eslint --fix"
+  },
+  "config": {
+    "commitizen": {
+      "path": ".stacks/node_modules/cz-git"
+    }
+  }
+}

package/core/tables/src/cli/index.ts

@@ -0,0 +1 @@
+export {}

package/core/tables/src/components/Demo.vue

@@ -0,0 +1,89 @@
+<script setup lang="ts">
+import { Table as TableV2 } from './main'
+
+const filterValues = {
+  website_access: [{
+    label: 'Yes',
+    value: 1,
+  }, {
+    label: 'No',
+    value: 0,
+  }],
+  disposition: [{
+    label: 'Active',
+    value: 'Active',
+  }, {
+    label: 'Released',
+    value: 'Released',
+  },
+  {
+    label: 'Terminated',
+    value: 'Terminated',
+  }],
+}
+</script>
+
+<template>
+  <div class="font-sans">
+    <Suspense>
+      <TableSearch />
+    </Suspense>
+
+    <Suspense>
+      <TableFilters :filter-values="filterValues" />
+    </Suspense>
+    <Suspense>
+      <TableV2
+        source="http://127.0.0.1:7700/"
+        password=""
+        type="users"
+        columns="
+          id: ID,
+          first_name: First Name,
+          last_name: Last Name,
+          npn: NPN,
+          email: Email,
+          website_access: Website Access,
+          disposition: Disposition"
+        sort="id:desc"
+        sorts="id, email, npn"
+        filters=""
+        actions="Info"
+        per-page="50"
+        selectable="true"
+      >
+        <template #id="id">
+          <a
+            href="#"
+            class="flex font-medium text-yellow-600"
+          >
+            {{ id.value }}
+          </a>
+        </template>
+
+        <template #customer_name="customerName">
+          <a
+            href="#"
+            class="flex font-medium text-yellow-600"
+          >
+            {{ customerName.value }}
+          </a>
+        </template>
+        <template #part_name="parts">
+          <a
+            v-for="(part, index) in parts.value"
+            :key="index"
+            href="#"
+            class="flex font-medium text-yellow-600"
+          >
+            {{ part }}
+          </a>
+        </template>
+      </TableV2>
+    </Suspense>
+
+    <Suspense>
+      <TablePagination />
+    </Suspense>
+  </div>
+</template>