{"id":23854969,"url":"https://github.com/ara-framework/hypernova-angular","last_synced_at":"2025-02-22T08:49:44.795Z","repository":{"id":48313841,"uuid":"189787506","full_name":"ara-framework/hypernova-angular","owner":"ara-framework","description":"Angular 5+ bindings for Hypernova.","archived":false,"fork":false,"pushed_at":"2021-08-02T05:58:10.000Z","size":15,"stargazers_count":2,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-05T14:17:34.241Z","etag":null,"topics":["angular","hypernova"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/hypernova-angular","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ara-framework.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-01T23:49:14.000Z","updated_at":"2020-03-24T02:58:13.000Z","dependencies_parsed_at":"2022-08-20T07:40:12.390Z","dependency_job_id":null,"html_url":"https://github.com/ara-framework/hypernova-angular","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ara-framework%2Fhypernova-angular","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ara-framework%2Fhypernova-angular/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ara-framework%2Fhypernova-angular/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ara-framework%2Fhypernova-angular/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ara-framework","download_url":"https://codeload.github.com/ara-framework/hypernova-angular/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240149746,"owners_count":19755743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","hypernova"],"created_at":"2025-01-03T00:19:31.401Z","updated_at":"2025-02-22T08:49:44.764Z","avatar_url":"https://github.com/ara-framework.png","language":"JavaScript","readme":"# hypernova-angular\n\n[Angular](https://angular.io/) bindings for [Hypernova](https://github.com/airbnb/hypernova).\n\nOn the server, wraps the component in a function to render it to a HTML string given its props.\n\nOn the client, uses the `HypernovaModuleFactory` to provide the metadata necessary to bootstrap the components.\n\n**Note**: `renderAngular` and `mountComponent` are not supported anymore. They were removed to move the boostrapping responsability to the library consumer in order to support AOT and JIT compiling.\n\n## Install\n\n```sh\nnpm install hypernova-angular\n```\n\n## Server Usage\n\nUses `renderAngular` to return hypernova bindings.\n\n```ts\nimport { renderAngular } from 'hypernova-angular/server'\n\nimport { ExampleModule } from './components/example/example.module'\nimport { ExampleComponent } from './components/example/example.component'\n\nhypernova({\n  getComponent (name) {\n    if (name === 'Example') {\n      return renderAngular(name, ExampleComponent, ExampleModule)\n    }\n  }\n}\n```\n\n## Browser Usage\n\nYou can use [Ara CLI](https://github.com/ara-framework/ara-cli) to create a service (Nova) with everything ready to start.\n\n```bash\nara new:nova -t angular\n```\n\nOr, you can use the following configurations.\n\n### App Module\n\nThe following code define a `AppModule` responsible of bootstrapping the Angular component in Hypernova placeholder.\n\n- `Hypernova.Name`: Name of the component to bootstrap.\n- `Hypernova.Node`: The placeholder where the component will be rendered.\n\n```ts\nimport { NgModule, Inject } from '@angular/core';\nimport { BrowserModule } from '@angular/platform-browser';\n\nimport { ExampleModule } from './components/example/example.module'\nimport { ExampleComponent } from './components/example/example.component';\n\nconst APP_ID = 'hypernova';\n\nconst components = {\n  'Example': ExampleComponent\n}\n\n@NgModule({\n  imports: [\n    ExampleModule,\n    BrowserModule.withServerTransition({ appId: APP_ID }),\n  ],\n  entryComponents: [ExampleComponent]\n})\nexport class AppModule {\n  constructor (\n    @Inject('Hypernova.Name') private name: string,\n    @Inject('Hypernova.Node') private node: HTMLElement\n    ){}\n\n  ngDoBootstrap(app) {\n    const Component = components[this.name]\n    if (Component) {\n      return app.bootstrap(Component, this.node)\n    }\n  };\n}\n```\n\nUse the `components` dictionary to support more components.\n\n```ts\nconst components = {\n  [Hypernova.Name]: AngularComponent\n}\n```\n\n### Browser JIT\n\n`browser.main.ts`\n```ts\nimport { platformBrowserDynamic } from '@angular/platform-browser-dynamic';\n\nimport { AppModule } from './app.module';\nimport { load, loadById, HypernovaModuleFactory } from 'hypernova-angular';\n\nimport { CompilerFactory, Compiler } from '@angular/core';\n\nconst platform = platformBrowserDynamic();\n\n// Compile module (JIT)\nconst compilerFactory: CompilerFactory = platform.injector.get(CompilerFactory);\n\nconst compiler: Compiler = compilerFactory.createCompiler([])\n\nconst moduleFactory = compiler.compileModuleSync(AppModule);\n\nconst render = (name: string, placeholder: any) =\u003e {\n\n  // Wrap module factory to provide necessary metadata to boostrap it.\n  const hypernovaModuleFactory = new HypernovaModuleFactory(moduleFactory, name, placeholder);\n\n  platform.bootstrapModuleFactory(hypernovaModuleFactory);\n}\n\n// Nova Bridge support\ndocument.addEventListener('NovaMount', (event) =\u003e {\n  const { name, id } = (\u003cCustomEvent\u003eevent).detail;\n\n  const placeholder = loadById(name, id);\n\n  if (placeholder) {\n    render(name, placeholder);\n  }\n})\n\n// Render in placeholders rendered by Hypernova Server\nload('Example').forEach(render.bind(this, 'Example'));\n```\n\n### Browser AOT\n\n`browser.aot.main.ts`\n```ts\nimport { platformBrowser } from '@angular/platform-browser';\nimport { AppModuleNgFactory } from './app.module.ngfactory';\nimport { load, loadById, HypernovaModuleFactory } from 'hypernova-angular';\n\nenableProdMode();\n\nconst render = (name: string, placeholder: any) =\u003e {\n  const hypernovaModuleFactory = new HypernovaModuleFactory(AppModuleNgFactory, name, placeholder);\n  platformBrowser().bootstrapModuleFactory(hypernovaModuleFactory);\n}\n\ndocument.addEventListener('NovaMount', (event) =\u003e {\n  const { name, id } = (\u003cCustomEvent\u003eevent).detail;\n\n  const placeholder = loadById(name, id);\n\n  if (placeholder) {\n    render(name, placeholder);\n  }\n})\n\nload('Example').forEach(render.bind(this, 'Example'));\n```","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fara-framework%2Fhypernova-angular","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fara-framework%2Fhypernova-angular","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fara-framework%2Fhypernova-angular/lists"}