9262727ae1
feat(docs): export type info for var and const exports
...
Closes #3700
2015-08-24 20:31:51 +00:00
a0b240884b
fix(.d.ts): show unknown fields as ‘any’ not ‘void’.
...
Closes #3637
2015-08-20 21:49:35 +00:00
9757c137db
docs(cleanup): Remove extra heading from nav and var templates
2015-08-19 12:25:13 -07:00
efbd8fca4c
build(typings): make router.d.ts depend on angular2.d.ts
...
if this is not done, DefinitelyTyped tests fail because of missing definitions for List, Map and other
apis that are part of router's public api
2015-08-19 10:10:31 -07:00
ea6673947c
refactor: rename annotations to metadata
...
BREAKING CHANGE (maybe)
Well as long as our customers use public API this should not be a
breaking change, but we have changed import structure as well as
internal names, so it could be breaking.
import:
angular2/annotations => angular2/metadata
Classes:
*Annotations => *Metadata
renderer.DirectiveMetadata => renderer.RendererDirectiveMetadata
renderer.ElementBinder => renderer.RendererElementBinder
impl.Directive => impl.DirectiveMetadata
impl.Component => impl.ComponentMetadata
impl.View => impl.ViewMetadata
Closes #3660
2015-08-17 21:23:25 +00:00
dfe0130753
docs(dgeni): Fix an extra newline in the markdown for type.
2015-08-14 01:48:24 +00:00
5a405011de
refactor(http): move http files to top-level module
...
Closes #2680
Closes #3417
2015-08-11 22:32:17 +00:00
dfa5103b1d
feat(typings): allow defining custom namespace for bundle
...
Allows declaring a bundle's namespace in generated typings file,
which should correspond to the global object representing the module
inside its bundle.
BREAKING CHANGE
The router was previously exported as ng.router in the
angular.sfx.dev.js bundle, but now it is exported as ngRouter.
Closes #2948
Closes #3544
2015-08-10 12:59:35 -07:00
1f692ae263
feat(typings): allow declaration of reference paths
...
Without this feature, each bundle would have to create its own typings
template to include references to dependent typings. Now, the references
can be declared in JS, along with other meta information about the
bundle typings.
Closes #3540
2015-08-10 12:58:49 -07:00
d40ff0bb89
chore(doc-gen): render enum doctypes correctly
2015-08-06 23:10:35 -07:00
c4296285f3
chore(doc-gen): render enum doctypes correctly
2015-08-06 23:10:35 -07:00
450d3630cc
test(router): add tests for router.d.ts
...
Closes #3282
2015-08-05 00:29:32 +00:00
53788ef827
revert "chore(doc-gen): render enum doctypes correctly"
...
This reverts commit b8e82e4db3
2015-08-03 11:00:47 +02:00
b8e82e4db3
chore(doc-gen): render enum doctypes correctly
2015-08-02 22:45:20 -07:00
dad9338c82
docs(type): Export Type so that we can link to it in our docs.
...
Closes #3345
2015-07-31 20:40:33 +00:00
f6da89f74f
chore(doc-gen): export interfaces over vars
...
If a symbol is declared as an interface and a var then we should export
it as an interface rather than a var.
2015-07-31 20:40:33 +00:00
cb6fc9c7cb
chore(doc-gen): fix jade whitespace errors
2015-07-30 11:29:06 +01:00
d426af741c
chore(doc-gen): trim leading blank lines from markdown content
...
Harp 0.17 does not allow blank lines to appear between filters and their
content. This change ensures that any blank lines that could appear have
been trimmed inside Nunkjucks.
Closes #3325
2015-07-28 13:48:03 -07:00
6ab2a871ce
chore(doc-gen): add `- var ...` to jade variable declarations
...
Harp 0.17 requires that jade variables are declared correctly
Closes #3325
2015-07-28 13:48:02 -07:00
81d298dc6b
chore(doc-gen): fix when decorator has no argument list
2015-07-28 12:45:51 +01:00
45cbc430e8
chore(doc-gen): render decorators (annotations) for exported classes
...
Closes #3167
Closes #3221
2015-07-28 11:29:56 +01:00
78fdf9a11f
fix(.d.ts): Correct new Type interface return type
...
Closes #2399
Closes #3316
2015-07-27 16:02:47 -07:00
19d8b221b4
fix(typings): test our .d.ts with --noImplicitAny
...
This matches how DefinitelyTyped tests it, so we are
one step closer to publishing the same file we generate.
See #3195
2015-07-24 11:24:44 -07:00
3c2b165de1
chore(doc-gen): add processor to check for unbalanced code fences (backticks)
...
See https://github.com/angular/angular/pull/3213/files#diff-da1eabc74e0bafaa56d2bfe4bc223b05R19
2015-07-23 09:35:03 +01:00
76f63bc6a5
chore(doc-gen/angular.io): check for not private rather is public
...
In 2e4a2a0e5aCloses #3212
2015-07-23 08:55:41 +01:00
4d80ce5b4a
chore(doc-gen): add some tests for typescript-definition-package
2015-07-12 19:10:58 +01:00
09bb114a4d
chore(doc-gen): convert heritage for private constructor classes
...
When we are creating a type definition file for a class has a private constructor,
we convert it to a combination of an instance of a concrete type with no constructor and an interface that contains the other methods.
When this happens, we must also convert the class's heritage from
`implements` to `extends` since interfaces cannot implement other interfaces
or classes.
Fixes a problem with #2996
Closes #3002
2015-07-12 18:53:31 +01:00
875db11822
chore(doc-gen): update dgeni-packages to 0.10.18
...
0.10.18 has fixed the `@private` tag so this is not needed locally any more
2015-07-11 07:21:46 +01:00
2e4a2a0e5a
chore(doc-gen): remove unnecessary `@public` and `@exportedAs` tags
2015-07-11 07:21:46 +01:00
9fa7d38133
chore(doc-gen): put typescript stuff into its own package
...
This means that we can now run just the d.ts file generation by running:
```bash
gulp docs/typings
```
In addition the type definition generation was messing with the other docs tasks
so separating it also fixes problems there.
2015-07-11 07:21:45 +01:00
927454c8fa
chore(doc-gen): don't use `string` module to stripTags
...
This module writes a file called `string` containing the text `testtest`
to the file system when it initialize.
See https://github.com/arturadib/shelljs/issues/212
2015-07-11 07:21:33 +01:00
b54e7214f0
chore: removed angular2.api.ts
...
BREACKING CHANGE:
We export InjectMetadata instead of InjectAnnotation
2015-07-09 13:54:07 -07:00
d050ce20a9
chore(doc-gen): fixup private constructor declarations
...
Closes #2883
2015-07-08 08:06:59 +02:00
12a427e158
fix(.d.ts): correct ComponentAnnotation inheritance
...
Closes #2356
2015-07-07 20:04:13 -07:00
0052c6b120
chore: improve angular2.d.ts file
...
- support ambient and import format for .d.ts
2015-07-07 20:04:13 -07:00
0e945e465d
chore(doc-gen): stop crash in `gulp public_docs`
...
This change prevents the doc generation from crashing due to a missing module,
but perhaps we need to think of a way of being able to generate the angular.d.ts
file correctly in `gulp public_docs`, perhaps by removing the need for
angular2/angular2.api
2015-07-07 20:04:13 -07:00
72257ec87d
chore(doc-gen): include type parameters in d.ts file
...
Closes #2859
2015-07-07 20:04:07 -07:00
355ced92eb
chore(doc-gen): fix spacing in heritage clauses
2015-07-07 22:04:10 +01:00
a56d33d7ca
feat(typings): mark void methods in angular2.d.ts
...
Previously, when a return type was missing it
could have been any. But following #2746 we
require return types so remaining untyped returns
must be void.
2015-07-06 17:25:59 -07:00
ad506a7aaa
chore(doc-gen): render "call" and "new" members of interfaces correctly
...
Partially Closes #2849
2015-07-03 09:00:20 +01:00
ef3cc8e6eb
chore(doc-gen): render optional members correctly
...
Partially Closes #2849
2015-07-03 09:00:20 +01:00
561b78a5b3
chore(doc-gen): generate router typings file
...
Closes #2659
2015-07-03 08:58:36 +01:00
a90063a827
chore(typing): restore some defn's now that dgeni is fixed
...
Closes #2446
Closes #2805
2015-07-01 12:53:10 +01:00
7a4a3c850f
fix(typings): Minor issues preventing angular2.d.ts from working in TS 1.4.
...
This removes some, but not all, of the manual work needed to patch up our
.d.ts for pushing to DefinitelyTyped. Remaining manual steps are:
- some types still missing
- declaration of decorators
- remove destructuring args
See #2686 .
2015-06-25 14:13:05 -07:00
24646e7eb8
feat(typings): add typing specs
...
add test in gulpfile which will compile a basic TS file with generated
angular2.d.ts to ensure generated d.ts is valid syntactic TS
Adds support for enums in .d.ts generation pipeline.
Removes renaming reexports in http module.
2015-06-23 18:22:47 -07:00
dee0e008f5
chore(doc-gen): refactor versionInfo logic to new `git` dgeni-package
...
Closes #2444
2015-06-21 02:15:42 +01:00
b8ef20e353
chore(doc-gen): ignore `@param` tags
...
At the moment we are not parsing param tags. This commit ignores them
completely.
TODO: hook up param descriptions with the actual param data in the doc.
Closes #2633
2015-06-19 12:10:01 -07:00
22f4cd26ae
chore(doc-gen): remove redundant processors from angular.io generation
2015-06-19 19:08:34 +01:00
5b5ffe75d0
docs(Http): add docs for Http lib
...
Fixes #2442
2015-06-16 15:42:18 -07:00
ea27704ea9
fix(docs): order class members in order of declaration
...
Previously, class members were ordered alphabetically.
This change leaves it up to the class author to
determine the order in which they would like
properties and methods to appear in class
documentation, without having to create methods like
`zUnimportantMethod`.
Fixes #2569
2015-06-16 15:21:54 -07:00
0c282e826a
chore(doc-gen): ensure github links have the correct text
2015-06-15 21:59:52 +01:00
8112b0baa7
chore(doc-gen): fix versionInfo population
2015-06-15 21:51:45 +01:00
14d28d7473
chore(doc-gen): fix id and alias generation for exports and members
...
This helps to ensure that links to exports are not confused with links
to members, which was causing some missing link issues.
Helps #2475
2015-06-15 00:11:59 +01:00
992293a196
chore(doc-gen): include `enum` in the export doc types
...
Fixes errors about missing "path templates" such as:
```
warn: No path template provided - doc "ViewType" (enum) - from file "angular2/src/render/api.ts"
warn: No output path template provided - doc "ViewType" (enum) - from file "angular2/src/render/api.ts"
```
2015-06-15 00:11:59 +01:00
a6e7123995
feat: adjust formatting for clang-format v1.0.19.
2015-06-12 09:51:57 -07:00
05d02fa90b
fix(docs): ensure no duplicates in alias names of docs
...
Having multiple identical names in a doc's aliases would cause Ambiguous Link warnings
for each reference to one of the aliases.
Related to #2452
2015-06-11 17:52:13 -07:00
796fc66771
chore(build): rename .es6 files to .js
...
Change es6 source files in npm distribution to use .js extensions.
Closes #2447
2015-06-11 17:22:19 -07:00
659adf83dc
chore(doc-gen): move typeParams and heritage rendering to template
...
Partially solves #2452
2015-06-11 19:15:17 +01:00
efab03274f
chore(doc-gen): autogenerate Angular version in angular.d.ts file
2015-06-10 12:42:24 +01:00
f2e2ce15cd
chore(doc-gen): add `type-alias` export doc type
...
See #2446
2015-06-10 12:14:10 +01:00
65cbcb2f73
chore(doc-gen): ensure `log` is injected into `getExportDocType`
...
See #2446
2015-06-09 23:07:35 +01:00
7141c15e65
fix(docs): Working generated angular2.d.ts
...
This requires some hacks, documented in
https://docs.google.com/document/d/1nNebWTiLzz5ePcit_bjZPtaiSIFU4EsQKUlX7LX0c0A/edit
Changes:
- include subtyping info in angular2.d.ts by adding 'extends supertype'
- export missing symbols needed transitively by angular2/angular2
- because of decorator/annotation mismatch, we can't export these to applications.
So I've added a separate angular2.api.ts file to re-export specifically to .d.ts
generation.
- Hack to remove aliases introduced by 'import * as alias' syntax
- Hack to deal with Error still an interface
note that we require users to install the transitive dependencies - this is how TSD works.
2015-06-05 15:33:23 -07:00
f303f0c17a
chore(docs): remove private members from angular2.d.ts
2015-06-02 17:15:49 -07:00
1fae8d6377
chore(doc-gen): add template for const docTypes
2015-06-02 15:30:03 -07:00
b746e0c9f0
docs(docgen): tell dgeni to use ts files and fix some bad links
2015-06-02 15:30:03 -07:00
e67b7e87b2
chore(docs): Improve whitespace and semicolons in angular2.d.ts
2015-06-02 15:29:07 -07:00
0a0b84a07d
fix(docs): generate d.ts file only for angular2/angular2.
2015-06-02 15:14:45 -07:00
a504fa835e
chore(doc-gen): improve github links to point to the correct tagged URL
...
Closes #1994
2015-06-02 10:56:23 +01:00
f6eeb9aa66
chore(doc-gen): dgenerate the type definition file for angular2
...
Closes #2017
Closes #1966
2015-05-20 12:23:59 +01:00
cd7aef2139
chore(doc-gen): fix up tests to work on linux
2015-05-19 14:38:11 +01:00
50c6efa187
chore(doc-gen): fix paths for links to modules and exports
2015-05-19 14:38:10 +01:00
302c5d5005
chore(doc-gen): paths now start with a slash
2015-05-19 14:38:10 +01:00
b6b9ede425
chore(doc-gen): include interfaces in the possible exports from a module
2015-05-19 14:38:10 +01:00
118f0520a2
chore(doc-gen): get CompilerHost to return the SourceFiles with the correct fileName
...
Now that we are not changing the working directory, we needed to update how
getSourceFiles works to ensure that it worked relative to the baseDir.
2015-05-19 14:38:10 +01:00
ba80bd43ad
chore(doc-gen): fix text mock code
2015-05-19 14:38:10 +01:00
ed6298c33f
chore(doc-gen): speed up class member sorting
2015-05-19 14:38:10 +01:00
db5486a347
chore(doc-gen): use actual TypeScript SymbolFlags enum rather than magic number
2015-05-19 14:38:10 +01:00
b9b58f7ed9
chore(doc-gen): speed up class member sorting
2015-05-19 14:38:10 +01:00
33f5aafd6c
chore(doc-gen): formatting
2015-05-19 14:38:09 +01:00
4b34ef9036
chore(doc-gen): remove unused `signature`
2015-05-19 14:38:09 +01:00
8c409e9251
chore(doc-gen): improve error handling for missing declaration params
2015-05-19 14:38:09 +01:00
398e70ad39
chore(doc-gen): allow class member sorting to be configured
2015-05-19 14:38:09 +01:00
9407c12923
chore(doc-gen): clarify and improve matching of exports to ignore
...
Previously this was a bit cryptic as we just had a `hideSpecialExports` flag.
Now it ignores exports that match an array of regexes, with the default case
being those exports called `___esModule`.
2015-05-19 14:38:09 +01:00
a4693ef679
squash-me: remove unnecessary (and very naughty) `chdir()` call
2015-05-19 14:38:09 +01:00
9d5f760597
chore(doc-gen): chore(doc-gen): add TypeScript parsing
2015-05-19 14:38:09 +01:00
8bebcfb844
chore(doc-gen): relax link matching
2015-05-19 14:38:09 +01:00
8a0eb08745
chore(doc-gen): relax link matching
2015-05-19 14:38:08 +01:00
1dce4699de
chore(doc-gen): relax link matching
2015-05-19 14:38:08 +01:00
7bff919782
chore(doc-gen): add TypeScript parsing
2015-05-19 14:38:08 +01:00
c6dc78183d
chore(doc-gen): relax link matching
2015-05-19 14:38:08 +01:00
9a72f19b97
chore(doc-gen): add TypeScript parsing
2015-05-19 14:38:08 +01:00
25a952755e
chore(doc-gen): remove Traceur bits
2015-05-19 14:38:08 +01:00
b2da2978ee
chore(doc-gen): move inline link matching to dgeni-package
2015-05-19 14:38:07 +01:00
72bb5bdd5a
chore(doc-gen): fix path to modules on angular.io
2015-05-19 14:38:07 +01:00
62bf777ef1
fix(docs): fix broken docs test after addition of .ts extension to dgeni
...
regex.
2015-05-07 14:05:57 -07:00
e30ad2ec2c
chore(doc-gen): include TypeScript files in the doc generation
2015-05-07 10:26:23 +01:00
c509057f65
chore(doc-gen): log comments as silly() rather than info()
2015-05-07 10:25:41 +01:00
e138add584
chore(doc-gen): provide aliases for jade-data docs
2015-05-07 10:25:02 +01:00
3f28d08778
build bug fix
2015-05-06 15:53:58 -07:00
ab28676d02
more comments
2015-05-06 15:36:02 -07:00
Brian Ford
Misko Hevery
Naomi Black
Igor Minar
Jeff Cross
Peter Bacon Darwin
Pawel Kozlowski
Alex Eagle
vsavkin
Daria Jung
Jacob Eggers
Martin Probst
Rob Wormald
Rado Kirov
Jeremy Elbourn
Alex Wolfe