Namespaces and modules

[vojtechhabarta]

Reflect changes in TypeScript terminology https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/Namespaces%20and%20Modules.md:

• namespaces (previously called internal modules)
• modules (previously called external modules)

User should have possibility to configure namespace or module name.

Examples:

// namespace
declare namespace NS1 {
    interface MyObject1 {}
}
// module
declare module 'mod2' {
    interface MyObject2 {}
}
// global
interface MyObject3 {}

[vojtechhabarta]

Summarizing export keyword usage in *.d.ts and also *.ts files for future reference:
example.d.ts file

// namespace
declare namespace NS1 {
    interface MayHaveExportKeyword1a {}
    export interface MayHaveExportKeyword1b {}
}
// global
interface CannotHaveExportKeyword4 {}

// module
declare module 'module2' {
    interface MayHaveExportKeyword2a {}
    export interface MayHaveExportKeyword2b {}
    // namespace inside a module
    namespace MayHaveExportKeywordNS3a {}
    export namespace MayHaveExportKeywordNS3b {}
}

no-module-compiler-flag.ts file

// namespace
namespace NS1 {
    export interface MustHaveExportKeyword1 {}
}
// global
interface CannotHaveExportKeyword4 {}

module2.ts file

// exported from module
export interface MustHaveExportKeyword2 {}
// namespace exported from a module
export namespace MustHaveExportKeywordNS3 {
    export interface MustHaveExportKeyword3 {}
}