ember-tribe 2.6.9 → 3.0.0

package/README.md

@@ -64,9 +64,9 @@ ember install ember-tribe
 
 The addon automatically configures following essential packages:
 
-**Ember Addons:** `ember-cli-dotenv`, `ember-cli-sass`, `ember-modifier`, `ember-composable-helpers`, `ember-truth-helpers`, `ember-file-upload` , `ember-power-select`
+**Ember Addons:** `ember-modifier`, `ember-composable-helpers`, `ember-truth-helpers`, `ember-file-upload` , `ember-power-select`
 
-**NPM Packages:** `bootstrap`, `@popperjs/core`, `animate.css`, `video.js`, `swiper`,  `howler`, `sortablejs`, `papaparse`
+**NPM Packages:** `bootstrap`, `@popperjs/core`, `animate.css`, `video.js`, `swiper`, `howler`, `sortablejs`, `papaparse`
 
 **Built-in features that can be used in routes and components**:
 
@@ -146,7 +146,7 @@ Always begin by understanding your data types, then define the routes that load
 **Types**
 
 8. **Start by Understanding Your Data**
-    Before writing any code, read the project description and `types.json` to understand the data model. Every architectural decision that follows — which routes to create, which services to build, whether components are even needed — depends on a clear understanding of the underlying types.
+   Before writing any code, read the project description and `types.json` to understand the data model. Every architectural decision that follows — which routes to create, which services to build, whether components are even needed — depends on a clear understanding of the underlying types.
 
 ---
 
@@ -156,7 +156,7 @@ Always begin by understanding your data types, then define the routes that load
    Match route names to user mental models. Use consistent, predictable naming conventions so that routes are self-documenting.
 
 10. **Routes Are for Fetching, Not Logic**
-   Routes should primarily perform read/fetch operations and pass data down to components or services. Keep JavaScript in routes to a minimum — business logic belongs in components and services, not routes.
+    Routes should primarily perform read/fetch operations and pass data down to components or services. Keep JavaScript in routes to a minimum — business logic belongs in components and services, not routes.
 
 11. **Route Parameters**
     Keep `get_vars` minimal and meaningful. Load only the data types that each specific route actually needs — avoid over-fetching.
@@ -270,7 +270,6 @@ The storylang.json file contains seven main sections:
 }
 ```
 
-
 #### Section Definitions
 
 #### 1. Types
@@ -284,7 +283,8 @@ The storylang.json file contains seven main sections:
   "types": [
     {
       "slug": "type-slug", //type slug as defined in `types.json` blueprint
-      "used_in": { //where this type is used
+      "used_in": {
+        //where this type is used
         "routes": ["route-name"],
         "components": ["component-name"],
         "services": ["service-name"],
@@ -314,7 +314,10 @@ The storylang.json file contains seven main sections:
       "tracked_vars": [{ "<variableName>": "<dataType>" }],
       "get_vars": [{ "<paramName>": "<dataType>" }],
       "getters": ["derived-property-name"],
-      "actions": ["frontend-action", { "backend-action": ["custom/path/file.php"] }],
+      "actions": [
+        "frontend-action",
+        { "backend-action": ["custom/path/file.php"] }
+      ],
       "functions": ["helper-method", "compute-something"],
       "helpers": ["helper1"],
       "services": ["service1"],
@@ -426,7 +429,10 @@ The storylang.json file contains seven main sections:
       "name": "service-name",
       "tracked_vars": [{ "<variableName>": "<dataType>" }],
       "getters": ["derived-property-name"],
-      "actions": ["frontend-action", { "backend-action": ["custom/path/file.php"] }],
+      "actions": [
+        "frontend-action",
+        { "backend-action": ["custom/path/file.php"] }
+      ],
       "functions": ["internal-method"],
       "helpers": ["helper1"],
       "services": ["dependency1", "dependency2"]
@@ -449,7 +455,11 @@ The storylang.json file contains seven main sections:
       "functions": ["build-visualization"],
       "actions": [
         "reset-state",
-        { "assemble-data-for-visualization": ["custom/visualizations/assemble-data.php"] },
+        {
+          "assemble-data-for-visualization": [
+            "custom/visualizations/assemble-data.php"
+          ]
+        },
         "updateVisualization"
       ],
       "helpers": ["validateConfig", "generatePreview"],
@@ -476,7 +486,10 @@ The storylang.json file contains seven main sections:
       "tracked_vars": [{ "<variableName>": "<dataType>" }],
       "inherited_args": [{ "<argumentName>": "<argType>" }],
       "getters": ["derived-property-name"],
-      "actions": ["frontend-action", { "backend-action": ["custom/path/file.php"] }],
+      "actions": [
+        "frontend-action",
+        { "backend-action": ["custom/path/file.php"] }
+      ],
       "functions": ["internal-method"],
       "helpers": ["helper1", "helper2"],
       "modifiers": ["modifier1"],
@@ -486,7 +499,6 @@ The storylang.json file contains seven main sections:
 }
 ```
 
-
 **Example**:
 
 ```json
@@ -502,7 +514,12 @@ The storylang.json file contains seven main sections:
         { "onDelete": "action" }
       ],
       "getters": ["trust-score-color", "display-label"],
-      "actions": ["toggle-selection", "expand-details", { "save-file": ["custom/files/save.php"] }, { "delete-file": ["custom/files/delete.php"] }],
+      "actions": [
+        "toggle-selection",
+        "expand-details",
+        { "save-file": ["custom/files/save.php"] },
+        { "delete-file": ["custom/files/delete.php"] }
+      ],
       "helpers": ["formatDate", "truncateText"],
       "modifiers": ["tooltip"],
       "services": ["store", "router"]
@@ -681,7 +698,7 @@ When querying records, `modules` and `filter` serve distinct purposes that map d
 
 **`modules`** applies **AND** logic: every key-value pair in the object must match for a record to be included. Use this when you want to narrow results to records that simultaneously satisfy all of the given conditions — for example, posts that are both `published` and belong to a specific `author_id`.
 
-**`filter`** applies **OR** logic: a record is included if it matches *any* of the key-value pairs. Use this when you want to broaden results across multiple values of a field — for example, items whose `category` is either `tech` or `design`.
+**`filter`** applies **OR** logic: a record is included if it matches _any_ of the key-value pairs. Use this when you want to broaden results across multiple values of a field — for example, items whose `category` is either `tech` or `design`.
 
 The two can be combined in the same query. For instance, to find all published posts that are tagged as either `news` or `feature`:
 
@@ -990,11 +1007,17 @@ import Service from '@ember/service';
 export default class ShoppingCartService extends Service {
   items = new TrackedArray([]);
 
-  add(item) { this.items.push(item) }
+  add(item) {
+    this.items.push(item);
+  }
 
-  remove(item) { this.items.splice(this.items.indexOf(item), 1) }
+  remove(item) {
+    this.items.splice(this.items.indexOf(item), 1);
+  }
 
-  empty() { this.items.splice(0, this.items.length) }
+  empty() {
+    this.items.splice(0, this.items.length);
+  }
 }
 ```
 
@@ -1109,16 +1132,16 @@ async uploadFile(file) {
 Use Ember's built-in `<Input>` component instead of a raw `<input>` tag — it automatically updates bound state via `@value`.
 
 ```handlebars
-<div class="mb-3">
-  <label for="input-name" class="form-label">Name:</label>
+<div class='mb-3'>
+  <label for='input-name' class='form-label'>Name:</label>
   <Input
-    id="input-name"
-    class="form-control"
-    @type="text"
+    id='input-name'
+    class='form-control'
+    @type='text'
     @value={{this.name}}
     disabled={{this.isReadOnly}}
-    maxlength="50"
-    placeholder="Enter your name"
+    maxlength='50'
+    placeholder='Enter your name'
   />
 </div>
 ```
@@ -1134,31 +1157,32 @@ export default class ExampleComponent extends Component {
 ```
 
 ```handlebars
-<div class="form-check mb-3">
+<div class='form-check mb-3'>
   <Input
-    id="admin-checkbox"
-    class="form-check-input"
-    @type="checkbox"
+    id='admin-checkbox'
+    class='form-check-input'
+    @type='checkbox'
     @checked={{this.isAdmin}}
-    {{on "input" this.validateRole}}
+    {{on 'input' this.validateRole}}
   />
-  <label for="admin-checkbox" class="form-check-label">Is Admin?</label>
+  <label for='admin-checkbox' class='form-check-label'>Is Admin?</label>
 </div>
 ```
 
 ```handlebars
-<div class="mb-3">
-  <label for="user-comment" class="form-label">Comment:</label>
+<div class='mb-3'>
+  <label for='user-comment' class='form-label'>Comment:</label>
   <Textarea
-    id="user-comment"
-    class="form-control"
+    id='user-comment'
+    class='form-control'
     @value={{this.userComment}}
-    rows="6"
+    rows='6'
   />
 </div>
 ```
 
 **Key rules for `<Input>` and `<Textarea>`:**
+
 - `@value`, `@type`, and `@checked` must be passed as **arguments** (with `@`).
 - Use the `{{on}}` modifier for event handling (e.g. `{{on "input" this.handler}}`).
 - Bootstrap styles `form-control` correctly when `disabled` is present
@@ -1170,14 +1194,14 @@ export default class ExampleComponent extends Component {
 **Single select (Bootstrap-compatible wrapper):**
 
 ```handlebars
-<div class="mb-3">
-  <label class="form-label">Assign Category:</label>
-  <div class="form-control p-0 border-0">
+<div class='mb-3'>
+  <label class='form-label'>Assign Category:</label>
+  <div class='form-control p-0 border-0'>
     <PowerSelect
       @options={{this.categories}}
       @selected={{this.selectedCategory}}
       @onChange={{this.handleCategoryChange}}
-      @placeholder="Select a category"
+      @placeholder='Select a category'
       as |category|
     >
       {{category.name}}
@@ -1210,14 +1234,14 @@ export default class ExampleComponent extends Component {
 **Multi-select variant:**
 
 ```handlebars
-<div class="mb-3">
-  <label class="form-label">Assign Tags:</label>
-  <div class="form-control p-0 border-0">
+<div class='mb-3'>
+  <label class='form-label'>Assign Tags:</label>
+  <div class='form-control p-0 border-0'>
     <PowerSelectMultiple
       @options={{this.availableTags}}
       @selected={{this.selectedTags}}
       @onChange={{this.handleTagsChange}}
-      @placeholder="Select tags"
+      @placeholder='Select tags'
       as |tag|
     >
       {{tag.label}}
@@ -1229,15 +1253,15 @@ export default class ExampleComponent extends Component {
 **Async options loaded from the store:**
 
 ```handlebars
-<div class="mb-3">
-  <label class="form-label">Select Project:</label>
-  <div class="form-control p-0 border-0">
+<div class='mb-3'>
+  <label class='form-label'>Select Project:</label>
+  <div class='form-control p-0 border-0'>
     <PowerSelect
       @options={{this.projects}}
       @selected={{this.selectedProject}}
       @onChange={{this.handleProjectChange}}
-      @searchField="name"
-      @placeholder="Search projects..."
+      @searchField='name'
+      @placeholder='Search projects...'
       as |project|
     >
       {{project.modules.name}}
@@ -1247,6 +1271,7 @@ export default class ExampleComponent extends Component {
 ```
 
 **Key rules for `<PowerSelect>`:**
+
 - `@options`, `@selected`, and `@onChange` are always required arguments.
 - Use `@searchField` to specify which object property drives the built-in search filter.
 - For multi-select, use `<PowerSelectMultiple>` — the `@onChange` callback receives the full updated array, so assign it directly to your tracked property.
@@ -1270,4 +1295,4 @@ You can then upload the `dist/` folder to [Junction (open source)](http://localh
 
 # License
 
-This project is licensed under the [GNU GPL v3 License](LICENSE.md).
+This project is licensed under the [GNU GPL v3 License](LICENSE.md).

package/blueprints/ember-tribe/files/app/index.html

@@ -1,30 +1,28 @@
-<!doctype html>
+<!DOCTYPE html>
 <html>
   <head>
-    <meta charset="utf-8" />
+    <meta charset="utf-8">
     <title><%= classifiedPackageName %></title>
     <meta name="description" content="" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
 
     {{content-for "head"}}
 
-    <link rel="manifest" href="{{rootURL}}manifest.webmanifest" />
-    <meta name="msapplication-config" content="{{rootURL}}browserconfig.xml" />
+    <link integrity="" rel="stylesheet" href="{{rootURL}}assets/vendor.css">
+    <link integrity="" rel="stylesheet" href="{{rootURL}}assets/new.css">
 
-    <link integrity="" rel="stylesheet" href="{{rootURL}}assets/vendor.css" />
     <link
-      integrity=""
       rel="stylesheet"
-      href="{{rootURL}}assets/<%= dasherizedPackageName %>.css"
-    />
-    <link
-      rel="stylesheet"
-      href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/7.0.1/css/all.min.css"
+      href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.7.2/css/all.min.css"
+      integrity="sha512-Evv84Mr4kqVGRNSgIGL/F/aIDqQb7xQ2vcrdIwxfjThSH8CSR7PBEakCr51Ck+w+/U6swU2Im1vVX0SVk9ABhg=="
+      crossorigin="anonymous"
+      referrerpolicy="no-referrer"
     />
 
     {{content-for "head-footer"}}
   </head>
   <body>
+    <!-- Full-screen loading overlay shown while Ember boots -->
     <div
       class="d-flex align-items-center justify-content-center vh-100 w-100 position-fixed animate__animated animate__fadeIn animate__faster"
       id="loading"
@@ -40,12 +38,16 @@
         class="position-absolute vh-100 w-100 bg-light opacity-75"
       ></div>
     </div>
-
+    
     {{content-for "body"}}
 
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/7.0.1/js/all.min.js"></script>
     <script src="{{rootURL}}assets/vendor.js"></script>
-    <script src="{{rootURL}}assets/<%= dasherizedPackageName %>.js"></script>
+    <script src="{{rootURL}}assets/new.js"></script>
+
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.7.2/js/all.min.js"
+      integrity="sha512-1mCLtfa/wR7Bxm5mXQrN9K5OPF8oE6DSGE+L9XS4MCQl1bWEBIfmFmQjH0BjkgBbXbJxqGvBFHN9VPuVoR3UA=="
+      crossorigin="anonymous"
+      referrerpolicy="no-referrer"></script>
 
     {{content-for "body-footer"}}
   </body>

package/blueprints/ember-tribe/files/config/environment.js

@@ -0,0 +1,54 @@
+'use strict';
+require('dotenv').config()
+
+module.exports = function (environment) {
+  const ENV = {
+    modulePrefix: 'new',
+    environment,
+    rootURL: '/',
+    locationType: 'history',
+    EmberENV: {
+      EXTEND_PROTOTYPES: false,
+      FEATURES: {
+        // Here you can enable experimental features on an ember canary build
+        // e.g. EMBER_NATIVE_DECORATOR_SUPPORT: true
+      },
+    },
+
+    APP: {
+      // Here you can pass flags/options to your application instance
+      // when it is created
+    },
+
+    TribeENV: {
+      API_URL: process.env.TRIBE_API_URL,
+      API_KEY: process.env.TRIBE_API_KEY,
+    },
+  };
+
+  if (environment === 'development') {
+    // ENV.APP.LOG_RESOLVER = true;
+    // ENV.APP.LOG_ACTIVE_GENERATION = true;
+    // ENV.APP.LOG_TRANSITIONS = true;
+    // ENV.APP.LOG_TRANSITIONS_INTERNAL = true;
+    // ENV.APP.LOG_VIEW_LOOKUPS = true;
+  }
+
+  if (environment === 'test') {
+    // Testem prefers this...
+    ENV.locationType = 'none';
+
+    // keep test console output quieter
+    ENV.APP.LOG_ACTIVE_GENERATION = false;
+    ENV.APP.LOG_VIEW_LOOKUPS = false;
+
+    ENV.APP.rootElement = '#ember-testing';
+    ENV.APP.autoboot = false;
+  }
+
+  if (environment === 'production') {
+    // here you can enable a production-specific feature
+  }
+
+  return ENV;
+};

package/blueprints/ember-tribe/files/ember-cli-build.js

@@ -0,0 +1,20 @@
+'use strict';
+require('dotenv').config();
+
+const { compatBuild } = require('@embroider/compat');
+const EmberApp = require('ember-cli/lib/broccoli/ember-app');
+
+module.exports = async function (defaults) {
+  const { buildOnce } = await import('@embroider/vite');
+
+  const app = new EmberApp(defaults, {
+    emberData: {
+      deprecations: { DEPRECATE_STORE_EXTENDS_EMBER_OBJECT: false }
+    }
+  });
+
+  return compatBuild(app, buildOnce, {
+    staticInvokables: true, // this is the default so you don't need to set it
+    splitAtRoutes: ['route.name'], // can also be a RegExp
+  );
+};

package/blueprints/ember-tribe/files/public/composer.json

@@ -1,15 +1,13 @@
 {
-  "name": "tribe/tribe",
-  "description": "Tribe is a project management framework by Wildfire.",
-  "license": "GPL-3.0-or-later",
-  "require": {
-    "php": "^8.0",
-    "tribe/core": "dev-dev",
-    "vlucas/phpdotenv": "^5.2",
-    "alsvanzelf/jsonapi": "^2.4",
-    "phpmailer/phpmailer": "^6.7",
-    "guzzlehttp/guzzle": "^7.7",
-    "pusher/pusher-php-server": "^7.2",
-    "agence104/livekit-server-sdk": "1.1"
-  }
+    "name": "tribe/tribe",
+    "description": "Tribe is a project management framework by Wildfire.",
+    "license": "GPL-3.0-or-later",
+    "require": {
+        "php": "^8.0",
+        "tribe/core": "^5.2",
+        "vlucas/phpdotenv": "^5.2",
+        "alsvanzelf/jsonapi": "^2.4",
+        "phpmailer/phpmailer": "^6.7",
+        "guzzlehttp/guzzle": "^7.7"
+    }
 }

package/blueprints/ember-tribe/files/pwa-assets.config.js

@@ -0,0 +1,12 @@
+import {
+  defineConfig,
+  minimal2023Preset as preset
+} from '@vite-pwa/assets-generator/config'
+
+export default defineConfig({
+  headLinkOptions: {
+    preset: '2023'
+  },
+  preset,
+  images: ['public/favicon.png']
+})

package/blueprints/ember-tribe/files/vite.config.js

@@ -0,0 +1,43 @@
+import { defineConfig } from 'vite';
+import { VitePWA } from 'vite-plugin-pwa';
+
+export default defineConfig({
+  plugins: [
+    // ...your other Ember/Vite plugins
+
+    VitePWA({
+      registerType: 'autoUpdate',
+      includeAssets: ['favicon.png', 'favicon.ico', 'apple-touch-icon.png', 'mask-icon.svg'],
+      manifest: {
+        name: 'ember-tribe',
+        short_name: 'ember-tribe',
+        description: 'Built using ember-tribe.',
+        start_url: '/',
+        scope: '/',
+        display: 'standalone',
+        background_color: '#e9ecef',
+        theme_color: '#0A1119',
+        prefer_related_applications: true,
+        icons: [
+          {
+            src: '/favicon.png',
+            sizes: '512x512',
+            type: 'image/png',
+          },
+          {
+            // PWA installers prefer a 'any maskable' entry
+            src: '/favicon.png',
+            sizes: '512x512',
+            type: 'image/png',
+            purpose: 'any maskable',
+          },
+        ],
+      },
+      // Apple / MS meta that vite-plugin-pwa injects into the HTML <head>
+      devOptions: {
+        enabled: true,
+      },
+    })
+  ]
+})
+

package/blueprints/ember-tribe/index.js

@@ -1,67 +1,61 @@
 'use strict';
 
 module.exports = {
-  normalizeEntityName() {}, // no-op since we're just adding dependencies
+  normalizeEntityName() {},
 
   afterInstall() {
-    return this.addAddonsToProject({
-      packages: [
-        { name: 'ember-cli-dotenv' },
-        { name: 'ember-cli-sass' },
-        { name: 'ember-cli-favicon' },
-        { name: '@ember/optional-features' },
-        { name: 'ember-modifier' },
-        { name: 'ember-composable-helpers' },
-        { name: 'ember-truth-helpers' },
-        { name: 'ember-svg-jar' },
-        { name: 'ember-math-helpers' },
-        { name: 'ember-cli-string-helpers' },
-        { name: 'ember-promise-helpers' },
-        { name: '@ember/test-waiters', target: '^3.1.0' },
-        { name: 'ember-tag-input' },
-        { name: 'ember-file-upload' },
-        { name: 'ember-toggle' },
-        { name: 'ember-basic-dropdown' },
-        { name: 'ember-power-select' },
-        { name: 'ember-click-outside' },
-        { name: 'ember-web-app' },
-        { name: 'tracked-built-ins' },
-        { name: 'ember-keyboard' },
-        { name: 'ember-router-scroll' },
-        { name: 'ember-concurrency' },
-        { name: 'ember-table' },
-        { name: 'ember-animated' },
-      ],
-    }).then(() => {
-      return this.addPackagesToProject([
-        { name: 'bootstrap' },
-        { name: '@popperjs/core' },
-        { name: 'animate.css' },
-        { name: 'video.js' },
-        { name: 'swiper' },
-        { name: 'howler' },
-        { name: 'ripplet.js' },
-        { name: '@ember/string' },
-        { name: '@editorjs/editorjs' },
-        { name: '@editorjs/image' },
-        { name: '@editorjs/header' },
-        { name: '@editorjs/raw' },
-        { name: '@editorjs/code' },
-        { name: '@editorjs/marker' },
-        { name: '@editorjs/delimiter' },
-        { name: '@editorjs/quote' },
-        { name: '@editorjs/list' },
-        { name: '@editorjs/attaches' },
-        { name: '@editorjs/footnotes' },
-        { name: '@editorjs/table' },
-        { name: 'editorjs-hyperlink' },
-        { name: 'miragejs' },
-        { name: 'papaparse' },
-        { name: 'sortablejs' },
-        { name: 'highlight.js' },
-        { name: 'uuid' },
-        { name: 'pretty-print-json' },
-      ]);
+    return this.addPackagesToProject([
+      { name: 'bootstrap' },
+      { name: '@popperjs/core' },
+      { name: 'sass' },
+      { name: 'animate.css' },
+      { name: 'video.js' },
+      { name: 'swiper' },
+      { name: 'howler' },
+      { name: '@editorjs/editorjs' },
+      { name: '@editorjs/image' },
+      { name: '@editorjs/header' },
+      { name: '@editorjs/raw' },
+      { name: '@editorjs/code' },
+      { name: '@editorjs/marker' },
+      { name: '@editorjs/delimiter' },
+      { name: '@editorjs/quote' },
+      { name: '@editorjs/list' },
+      { name: '@editorjs/attaches' },
+      { name: '@editorjs/footnotes' },
+      { name: '@editorjs/table' },
+      { name: 'editorjs-hyperlink' },
+      { name: '@embroider/vite' },
+      { name: '@embroider/compat' },
+      { name: 'miragejs' },
+      { name: 'papaparse' },
+      { name: 'sortablejs' },
+      { name: 'highlight.js' },
+      { name: 'uuid' },
+      { name: 'pretty-print-json' },
+      { name: 'dotenv' },
+      { name: '@vite-pwa/assets-generator' },
+      { name: 'vite-plugin-pwa' },
+    ]).then(() => {
+      return this.addAddonsToProject({
+        packages: [
+          { name: 'ember-modifier' },
+          { name: '@nullvoxpopuli/ember-composable-helpers' },
+          { name: 'ember-truth-helpers' },
+          { name: 'ember-math-helpers' },
+          { name: 'ember-cli-string-helpers' },
+          { name: 'ember-promise-helpers' },
+          { name: 'ember-tag-input' },
+          { name: 'ember-file-upload' },
+          { name: 'ember-toggle' },
+          { name: 'ember-basic-dropdown' },
+          { name: 'ember-power-select' },
+          { name: 'ember-click-outside' },
+          { name: 'ember-keyboard' },
+          { name: 'ember-concurrency' },
+          { name: 'ember-animated' },
+        ],
+      });
     });
   },
 };