NOTES.md

Debugging

$ node --inspect-brk ./node_modules/.bin/ember serve
$ chrome://inspect

Runtime stats

// app/templates/application.hbs
<Zuglet::Stats @stores={{false}}/>

Decorators

@route

import Route from '@ember/routing/route';
import { inject as service } from '@ember/service';
import { route } from 'zuglet/decorators';

@route()
export default class RouteRoute extends Route {

  @service
  store

  // is activated when this returns
  async model() {
    return this.store.models.create('messages');
  }

  // right after model is activated
  // optionally preload data before model() hook resolves
  async load(model) {
    await model.load();
  }

}

@root

import Component from '@glimmer/component';
import { inject as service } from '@ember/service';
import { root, activate } from 'zuglet/decorators';

@root() // activates on create and deactivates on willDestroy
export default class RouteDevComponent extends Component {

  @service
  store

  // this is activated on 1st access
  @activate().content(({ store }) = store.doc('messages/first').existing())
  doc

}

@activate

@activate()
  .content(({ store, id }) => store.collection('messages').where('owner', '==', id).query())

• if content args changes, content is recreated

@model

@model()
  .named(({ name }) => name)
  .mapping(({ id }) => ({ id }))

• if modelname changes, model is recreated
• if mapping changes, but modelName hasn't changed, mappingDidChange is invoked
• if model.mappindDidChange doesn't exist, model is recreated
• mapping properties are diffed individually

@models

@models()
  .source(({ query }) => query.content)
  .named((doc, owner) => `thing/${doc.data.type}`)
  .mapping((doc, owner) => ({ doc }))

• if modelname changes, model is recreated
• if mapping changes, but modelName hasn't changed, mappingDidChange is invoked
• if model.mappindDidChange doesn't exist, model is recreated
• mapping properties are diffed individually